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前 言 


虽然 我 从 事 Android 开 发 工作 已 经 很 多 年 了 ， 但 是 之 前 从 来 没有 想 过 目 己 要 
去 写 一 本 Android 技 术 相 关 的 书 。 在 我 看 来 ， 写 一 本 书 可 以 算 征 一 个 很 庞大 
的 工程 ， 写 一 本 好 书 的 难度 并 不 亚 于 开发 一 款 好 的 应 用 程序 。 


由 于 我 长 期 坚持 在 CSDN 上 发 表 技术 博文 ， 因 而 得 到 了 大 量 网 友 的 认可 ， 也 
积 素 了 一 定 的 名 气 。 很 采 幸 的 是 ， 人 民 邮 电 出 版 社 图 灵 公 司 的 前 副 总 编辑 

陈 冰 老师 联系 上 了 我 ， 布 望 我 可 以 写 一 本 关于 Android 开 发 技术 的 书 ， 这 着 
实 让 我 受 宠 帮 尺 。 


在 写本 书 第 1 版 的 时 候 ， 我 可 以 说 是 费 了 相当 大 的 心思 。 写 书 和 写 博客 最 大 
的 区 别 在 于 ， 书 的 内 容 不 能 像 博客 那样 散乱 ， 不 能 想到 哪里 写 到 哪里 ， 而 
是 一 定 要 系统 化 ， 要 循序 渐进 ， 基 本 上 在 写 第 1 章 的 时 候 就 应 该 把 全 书 的 内 
容 都 确定 下 来 了 。 


令 我 非常 欣慰 的 是 ， 本 书 的 第 1 版 在 推出 之 后 获得 了 广大 读者 的 强烈 认可 ， 
在 短 短 两 年 时 间 内 ， 已 经 成 为 了 国内 最 畅销 的 Android 技 术 书 。 各 大 书店 、 
图 书馆 都 能 看 到 《第 一 行 代码 》 的 映 影 ， 许 多 学 校 和 培训 机 构 也 纷纷 将 
《第 一 行 代码 》 选 为 Android 课 程 的 教材 。 


不 过 ， 在 科技 高 速 发 展 的 今天 ， 各 种 技术 的 发 展 都 是 日 新 月 异 的。 在 两 年 

的 时 间 里 ，Android 操 作 系 统 经 历 了 5.0、6.0、7.0 的 飞速 升级 。 不 可 否认 的 

征 ， 本 书 第 1 版 中 的 不 少 知识 点 都 已 经 过 时 ， 而 且 这 两 年 间 出 现 的 很 多 新 知 
识 ， 第 1 版 中 也 没有 涵盖 。 因 此 ， 这 让 我 坚定 了 写作 本 书 第 2 版 的 想法 。 


刚 开 始 写 的 时 候 ， 我 以 为 只 是 小 修 小 补 ， 但 事实 上 并 没有 我 想象 得 那么 轻 
松 。 除 了 介绍 新 知识 点 以 外 ， 书 中 之 前 的 所 有 项 目 都 需要 重新 编写 和 测 
试 ， 以 保证 代码 在 新 老 系统 上 的 兼容 性 。 男 外 ， 由 于 Android 从 5.0 系 统 开 
始 ，UI 风 格 变化 很 大 ， 因 此 第 1 版 中 所 有 的 截图 都 需要 更 新 。 室 不 僵 张 地 
说 ， 我 几乎 重 写 了 整 本 书 。 


而 现在 ， 你 手中 捧 着 的 正 是 全 新 版 的 《第 一 行 代码 》， 同 时 这 也 是 国内 第 
一 本 基于 Android 7.0 系 统 写 作 的 技术 书 。 我 真诚 地 希望 你 可 以 用 心 去 阅读 这 
本 书 ， 因 为 每 多 掌握 一 份 知 识 ， 你 束 会 多 一 份 豆 悦 。Enjoy it! 


第 2 版 的 变化 


由 于 第 2 版 修改 内 容 迷 多 ， 因 此 这 里 我 只 列举 出 最 主要 的 变化 。 百 移 是 开发 
工具 上 的 改变 ， 本 书 第 1 版 使 用 的 开发 工具 是 Eclipse， 而 第 2 版 使 用 了 目前 
最 新 的 Android Studio 2.2 版 本 。 万 外 ， 本 书 第 1 版 是 基于 Android 4.x 系 统 
的 ， 而 第 2 版 是 基于 Android 7.0 系 统 的 ， 其 中 宫 括 了 新 系统 中 的 诸多 知识 
点 ， 包 括 Android 5.0 系 统 中 引入 的 Material Design、Android 6.0 系 统 中 引入 
的 运行 时 权限 和 Doze 模 式 、Android 7.0 系 统 中 引入 的 多 窗口 模式 等 。 


除 此 之 外 ， 第 2 版 还 加 入 了 Gradle、RecyclerView、 百分比 布局 、OkHttp、 
Lambda 表 达 式 等 全 产 知 识 点 的 讲解 ， 内 容 将 前 所 未 有 地 充实 。 


本 书 内 容 通 俗 易 懂 ， 由 浅 入 深 ， 既 适合 初学 者 阅读 ， 也 同样 适合 专业 人 
员 。 学 习 本 书 内 容 之 前 ， 你 并 不 需要 有 任何 的 Android 基 础 ， 但 是 你 需要 有 
一 定 的 Java 基 础 ， 因 为 Android 开 发 都 是 使 用 Java 语 言 的 ， 而 本 书 并 不 会 去 
专门 介绍 Java 方 面 的 知识 。 


阅读 本 书 时 ， 你 可 以 根据 上 自身 的 情况 来 决定 如 何 阅读 。 如 果 你 是 初学 者 的 
话 ， 建 议 你 从 第 1 章 开 始 循序 渐进 地 阅读 ， 这 样 理解 起 来 就 不 会 感到 吃力 。 
而 如 果 你 已 经 有 了 一 定 的 Android 基 础 ， 那 么 就 可 以 选择 某 些 你 感 兴 趣 的 章 
人 阅读 。 但 请 记 住 ， 很 多 章 最 后 的 最 佳 实践 部 分 一 定 是 你 不 
想 错过 的 。 


本 书 内 容 


正如 前 面 所 说 ， 本 书 的 内 容 是 非常 系统 化 的 ， 不 仅 全 面 介绍 了 那些 你 必须 
掌握 的 知识 ， 而 且 保证 了 各 半 的 难度 都 是 梯度 式 上 升 的 。 全 书 一 共 分 为 15 
章 ， 涵 者 了 四 大 组 件 、UI、 碎片 、 数 据 存储 、 多 媒体 、 网 络 、 定 位 服务 等 
方方面面 的 知识 。 为 了 让 你 在 学 完 所 有 内 容 之 后 还 可 以 有 综合 运用 的 能 
力 ， 本 书 的 尾声 部 分 还 会 带 你 一 起 开发 一 个 天 气 预 报 程序 ， 并 教会 你 如 何 
将 程序 发 布 到 应 用 商店 ， 以 及 如 何在 程序 中 骨 入 广告 僵 利 。 


除 此 之 外 ， 本 书 的 第 5 章 、 第 7 章 、 第 11 划 、 第 14 章 中 都 罕 插 有 对 Git 的 讲 
解 ， 如 有 果 想 要 掌握 它 的 用 法 ， 这 几 章 的 内 容 是 绝对 不 能 错过 的 。 


本 书 中 各 个 章节 的 内 容 都 相对 比较 独立 ， 因 此 除了 可 以 循序 渐进 地 学 习 之 
外 ， 你 还 可 以 把 它 当成 一 本 参考 手册 ， 随 时 查阅 。 


源码 下 载 


百 完 ， 我 建议 你 在 学 习 本 书 的 时 候 将 所 有 项 目的 源码 都 亲手 痪 上 一 这 ， 因 
为 只 有 这 样 才能 加 深 你 对 代码 的 理解 。 不 过 为 了 方便 于 你 的 学 习 ， 我 还 是 
提供 了 书 中 所 有 项 目的 源码 ， 请 仅 在 需要 的 时 候 再 去 参考 (如 下 载 项 目 中 
的 图 片 资源 ) 。 切 勿 直接 将 源码 复制 烙 贴 就 当成 自己 的 东西 了 ， 只 有 亲手 
敲 过 的 代码 才 真 正 是 你 自己 的 。 


源码 下 载 地 址 : https://github.com/guolindev/booksource 。 


致谢 


在 这 近 一 年 的 时 间 里 ， 我 又 完成 了 一 项 浩大 的 工程 。 和 写作 本 书 第 1 版 时 的 
感觉 类 似 ， 当 全 书 完 稿 之 后 ， 回 顾 整 本 书 ， 我 仍然 不 敢 相信 这 所 有 的 内 容 
竟然 是 我 一 字 字 地 敲 出 来 的 。 


如 今 这 已 经 是 我 写 的 第 二 本 书 了 ， 和 写 第 一 本 书 时 的 情况 不 同 ， 现 在 我 有 
了 更 广 的 人 脉 和 资源 ， 有 了 更 多 的 人 愿意 帮助 和 文 持 我 来 完成 一 本 更 好 的 
技术 书 。 因 此 ， 我 要 在 这 里 对 很 多 人 表示 感谢 。 


首先 我 要 感谢 我 的 父母 ， 感 谢 你 们 将 我 抚养 长 大 ， 感 谢 你 们 的 付出 ， 让 我 
从 小 不 用 为 生计 、 上 学 而 发 条 ， 可 以 一 直 做 我 目 己 想 做 的 事情 ， 也 感谢 你 
们 指引 我 走 上 了 技术 这 条 路 。 


其 次 我 要 感谢 我 的 妻子， 感谢 你 每 天 为 我 准备 好 一 日 三 餐 ， 感 谢 你 对 我 永 
ee 
和 文 持 我 。 


我 还 非常 感谢 本 书 第 1 版 的 编辑 陈 冰 老师 ， 如 果 没 有 你 当初 在 CSDN 上 找到 
我 ， 并 邀请 我 写 书 ， 束 不 会 有 现在 的 《第 一 行 代码 》。 男 外 ， 你 也 是 当时 
CR 


我 也 非常 感谢 本 书 第 2 版 的 编辑 张 霞 ， 你 全 程 负 责 了 第 2 版 的 出 版 工作 ， 并 
且 完 成 得 非常 出 色 。 你 对 文字 的 把 控 能 力 让 我 敬佩 ， 感 谢 你 对 书 中 每 一 章 
节 的 尽心 审阅 ， 才 能 让 这 本 书 更 趋 近 于 完美 。 


另外 我 还 要 特别 感谢 一 部 分 人 ， 你 们 在 对 本 书 的 内 容 建议 、 勘 误 检查 、 代 
码 纠 错 ， 攻 至 是 对 我 个 人 的 文 持 等 方面 都 作出 了 嘲 越 的 页 献 。 有 了 你 们 的 
帮助 ， 才 会 有 这 样 一 本 更 加 出 色 的 书 呈现 在 所 有 人 面前 ， 这 本 书 上 也 理应 
有 你 们 的 名 字 ( 按 姓氏 拼音 排序 ， 排 名 不 分 先后 ) : 


陈 建 林 陈 俊 杰 陈 雷 陈 龙 陈 琪 陈 秀 相 陈 逸 鸣 代 云 蚁 
董 霖 轩 ”上 段 郭 森 
高 知 泉 ”高 太 稳 、 关 爱民 ”何以 诚 ” 胡 恩泽 黄 桶 赖 帆 李 济 洲 
李 建 友 ” 李 沛 明 
李 潭 李 永 鹏 李 志 云 林 火 用 刘 萌 刘 明 渊 刘 治 国 ” 陆 德 俊 
罗 亚 超 ”号 国 狗 
马 文 杰 ” 蕴 文 江 和 孙 建 飞 王 柏 强 王 光 东 王 杰 王 龙 王 路 路 
王 鹏 王 荣 宗 
王 善 昌 韦 振 南 吴 波 吴 宏 权 吴 绍 志 徐 阳 轩 仲 宽 杨 辉 
易 静 杰 查 童 
张 鸿 洋 。 张 英 祥 ”、 赵 恕 龙 ” 赵 庆 元 。 赵 迎 超 ” 郑 传 书 ” 郑 敏 世 ” 庄 育 锋 
周 苏 朱 海 丰 


第 1 章 开始 启程 
Android 代 码 


欢迎 你 来 到 Android 世 界 ! Android 系 统 是 目前 世界 上 市 场 占有 率 最 高 的 移动 
操作 系统 ， 不 管 你 在 哪里 ， 都 可 以 看 到 Android 手 机 几乎 无 处 不 在 。 今 天 的 
Android 世 界 可 谓 欣欣 向 荣 ， 可 是 你 知道 它 的 过 去 是 什么 样 的 吗 ?我 们 一 起 
来 看 一 看 它 的 发 展 史 吧 。 


你 的 第 一 行 


2003 年 10 月 ，Andy Rubin 等 人 一 起 创办 了 Android 公 司 。2005 年 8 月 谷歌 收购 
了 这 家 仅仅 成 立 了 22 个 月 的 公司 ， 并 让 Andy Rubin 继 续 负 责 Android 项 目 。 
在 经 过 了 数 年 的 研发 之 后 ， 谷 歌 终 于 在 2008 年 推出 了 Android 系 统 的 第 一 个 
版 本 。 但 目 那 之 后 ，Android 的 发 展 就 一 直 受 到 重重 阻挠 。 乔 布 斯 自始至终 
认为 Android 是 一 个 抄袭 iPhone 的 产品 ， 里 面 简 礼 了 诸多 iPhone 的 创意 ， 并 
声称 一 定 要 毁 掉 Android。 而 本 吴 束 是 基于 Linux 开 发 的 Android 操 作 系 统 ， 
在 2010 年 被 Linux 团 队 从 Linux 内 核 主 线 中 除名 。 又 由 于 Android 中 的 应 用 程 
序 都 是 使 用 Java 开 发 的 ， 甲 骨 文 则 针对 Android 侵 犯 Java 知 识 产权 一 事 对 谷 
歌 提起 了 诉讼 .……. 


可 是 ， 似 乎 再 多 的 困难 也 阻挡 不 了 Android 快 速 前 进 的 步伐 。 由 于 谷歌 的 开 
放 政 案 ， 任 何 手 机 厂商 和 个 人 都 能 免费 获取 到 Android 操 作 系 统 的 源码 ， 并 
且 可 以 自由 地 使 用 和 定制 。 三 星 、HTC、 摩 托 罗 拉 、 索 爱 等 公司 都 推出 了 
各 目 系 列 的 Android 手 机 ，Android 市 场 上 百花 齐 放 。 仅 仅 推 出 两 年 后 ， 
Android 就 超过 了 已 经 霸占 市 场 逾 十 年 的 诺基亚 Symbian， 成 为 了 全 球 第 一 
大 智能 手机 操作 系统 ， 并 且 每 天 都 还 会 有 数 百 万 台新 的 Android 设 备 被 激 
活 。 而 近 几 年， 国内 的 手机 厂商 也 是 大 放 异 彩 ， 小 米 、 华 为 、 魅 族 等 狐 兴 
品牌 都 推出 了 相当 不 错 的 Android 手 机 ， 并 且 也 获得 了 市 场 的 广泛 认可 ， 目 
前 Android 已 经 占据 了 全 球 智能 手机 操作 系统 70% 以 上 的 份额 。 


说 了 这 些 ， 想 必 你 已 经 体会 到 Android 系 统 和 炙手可热 的 程度 ， 并 且 迫 不 及 待 
地 想 要 加 入 到 Android 开 发 者 的 行列 当中 了 吧 。 试 想 一 下 ， 十 个 人 中 有 七 个 
人 的 手机 都 可 以 运行 你 编写 的 应 用 程序 ， 还 有 什么 能 比 这 个 更 诱 人 的 呢 ? 
那么 从 今天 起 ， 我 就 带 你 踏 上 学 习 Android 的 旅途 ， 一 步 步 地 引导 你 成 为 一 
名 出 色 的 Android 开 发 者 。 


好 了 ， 现 在 我 们 吏 来 一 起 初 蜂 一 下 Android 世 界 吧 。 


1.1 了 解 全 够 _ Android 王国 简介 


Android 从 面世 以 来 到 现在 已 经 发 布 了 二 十 几 个 版 本 了 。 在 这 几 年 的 发 展 过 
程 中 ， 合 歌 为 Android 王 国 建立 了 一 个 完整 的 生态 系统 。 手 机 厂商 、 开 发 
者 、 用 户 之 间 相 互 依存 ， 共 同 推进 着 Android 的 鞍 勃 发 展 。 开 发 者 在 其 中 扮 
演 着 不 可 或 缺 的 角色 ， 因 为 如 果 没 有 开发 者 来 制作 丰富 的 应 用 程序 ， 那 么 
不 管 多 么 优秀 的 操作 系统 ， 也 是 难以 得 到 大 从 用 户 喜 受 的 ， 相 信 没 有 多 少 
和 人 能够 忍受 没有 QQ、 微 信 的 手机 吧 。 而 且 ， 合 歌 推 出 的 Google Play 更 是 给 
开发 者 带 来 了 大 量 的 机 遇 ， 只 要 你 能 制作 出 优秀 的 产品 ， 在 Google Play 上 


获得 了 用 户 的 认可 ， 你 就 完全 可 以 得 到 不 错 的 经 济 回报 ， 从 而 成 为 一 名 独 
立 开发 者 ， 甚 至 是 成 功 创业 1 


那 我 们 现在 束 以 一 个 开发 者 的 角度 ， 去 了 解 一 下 这 个 操作 系统 吧 。 纯 理论 
型 的 东西 也 比较 无 聊 ， 怕 你 看 睡 着 了 ， 因 此 我 只 挑 重点 介绍 ， 这 些 东 西 跟 
你 以 后 的 开发 工作 都 是 轧 电 相关 的 。 


1.1.1 _ Android 系统 架构 


为 了 让 你 能 够 更 好 地 理解 Android 系 统 是 怎么 工作 的 ， 我 们 先 来 看 一 下 写 的 
系统 染 构 。Android 大 致 可 以 分 为 四 层 架 构 ，Linux 内 核 层 、 系 统 运行 库 层 、 
应 用 框架 层 和 应 用 层 。 


01. Linux 内 核 层 


Android 系 统 是 基于 Linux 内 核 的 ， 这 一 层 为 Android 设 备 的 各 种 硬件 提 
供 了 底层 的 驱动 ， 如 显示 驱动 、 首 频 驱 动 、 照 相机 驱动 、 蓝 牙 驱 动 、 
Wi-Fi 驱 动 、 电 源 管理 等 。 


02. 系统 运行 库 层 


这 一 层 通过 一 些 C/C++ 库 来 为 Android 系 统 提 供 了 主要 的 特性 文 持 。 如 
SQLite 库 提供 了 数据 库 的 支持 ，OpenGLIES 库 提供 了 3D 绘 图 的 文 持 ， 
Webkit 库 提供 了 浏览 器 内 核 的 文 持 等 。 


同样 在 这 一 层 还 有 Android 运 行 时 库 ， 它 主要 提供 了 一 些 核心 库 ， 能 够 
人 允许 开发 者 使 用 Java 语 言 来 编写 Android 上 应用。 另外 ，Android 运 行 时 库 
中 还 包含 了 Dalvik 虚 拟 机 (5.0 系 统 之 后 改 为 ART 运 行 环境 ) ， 它 使 得 

每 一 个 Android 应 用 都 能 运行 在 独立 的 进程 当中 ， 并 且 拥 有 一 个 自己 的 
Dalvik 虚 拟 机 实例 。 相 较 于 Java 虚 拟 机 ，Dalvik 是 专门 为 移动 设备 定制 
的 ， 它 针对 手机 内 存 、CPU 性 能 有 限 等 情况 做 了 优化 处 理 。 


. 应 用 框架 层 
这 一 层 主要 提供 了 构建 应 用 程序 时 可 能 用 到 的 各 种 API，Android 目 市 
的 一 些 核心 应 用 就 是 使 用 这 些 API 完 成 的 ， 开 发 者 也 可 以 通过 使 用 这 些 
API 来 构建 自己 的 应 用 程序 。 


04. 应 用 层 


0 


CU 


所 有 安装 在 手机 上 的 应 用 程序 都 是 属于 这 一 层 的 ， 比 如 系统 自 带 的 联 
系 人 、 短 信 等 程序 ， 或 者 是 你 从 Google Play 上 下 载 的 小 游戏 ， 当 然 还 
包括 你 自己 开发 的 程序 。 


结合 图 1.1 你 将 会 理解 得 更 加 深刻 ， 图 片 源 目 维基 百科 。 


APPLICATIONS 


Contacts Phone 


APPLICATION FRAMEWORK 


Activity Window Content VieW Notification 


Manager Mik Tek Tel Providers System Manager 


Package Telephony Resource Location XMPP 
Manager Manager Manager Manager Service 


LIBRARIES ANDROID RUNTIME 


Surface Media Core 
Manager Framework Libraries 


OpenGLIES FreeType WebkKit 


LINUX KERNEL 
Driver Driver Driver Driver 


Driver Driver Driver Management 


图 1.1 Android 系统 架 构 
1.1.2 ” Android 已 发 布 的 版 本 


2008 年 9 月 ， 谷 歌 正式 发 布 了 Android 1.0 系 统 ， 这 也 是 Android 系 统 最 早 的 版 
本 。 随 后 的 几 年 ， 谷 歌 以 惊人 的 速度 不 断 地 更 新 Android 系 统 ，2.1、2.2、 
2.3 系 统 的 推出 使 Android 占 据 了 大 量 的 市 场 。2011 年 2 月 ， 谷 歌 发 布 了 
Android 3.0 系 统 ， 这 个 系统 版 本 是 专门 为 平板 电脑 设计 的 ， 但 也 是 Android 
为 数 不 多 的 比较 失败 的 版 本 ， 推 出 之 后 一 直 不 见 什么 起 色 ， 市 场 份 额 也 少 
得 可 怜 。 不 过 很 快 ， 在 同年 的 10 月 ， 谷 歌 又 发 布 了 Android 4.0 系 统 ， 这 个 版 


本 不 再 对 手机 和 平板 进行 差异 化 区 分 ， 既 可 以 应 用 在 手机 上 ， 也 可 以 应 用 
在 平板 上 。2014 年 Google IO 大 会 上 ， 谷 歌 推出 了 号 称 史 上 版 本 改动 最 大 的 
Android 5.0 系 统 ， 其 中 使 用 ART 运 行 环境 奉 代 了 Dalvik 虚 拟 机 ， 大 大 提升 了 
应 用 的 运行 速度 ， 还 提出 了 Material Design 的 概念 来 优化 应 用 人 ° 
除 此 之 外 ， 还 推出 了 Android Wear、Android Auto、Android TV 系统 ， 从 而 
进军 可 穿戴 设备 、 汽 车 、 电 视 等 全 新 领域 。 之 后 Android 的 更 新 速度 更 加 迅 
速 ，2015 年 Google IO 大 会 上 推出 了 Android 6.0 系 统 ， 加 入 运行 时 权限 功 
2016 年 Google IO 大 会 上 推出 了 Android 7.0 系 统 ， 加 入 多 窗口 模式 功 
这 也 是 目前 最 新 的 Android 系 统 版 本 。 


下 表 列 出 了 日 前 主要 的 Android 系 统 版 本 及 其 详细 信息 。 你 看 到 这 张 表格 


IO ZI 


已 
已 ， 
[a 
巴 


时 ， 数 据 可 能 已 经 发 生 了 变化 ， 碍 看 最 新 的 数据 可 以 访问 


市 场 占有 率 


Froyo 0.1% 
Gingerbread 1.5% 


http://developer.android.google.cn/about/dashboards/ ° 


50 13.1% 


从 上 表 中 可 以 看 出 ， 目 前 4.0 以 上 的 系统 已 经 占据 了 超过 98% 的 Android 市 场 
份额 ， 因 此 我 们 本 书 中 开发 的 程序 也 只 面向 4.0 以 上 的 系统 ，2.x 的 系统 就 不 


再 去 兼 


容 了 。 


1.1.3” Android 应 用 开发 特色 

预告 二 下， 你 马上 就 要 开始 真正 的 Android 开 发 旅程 了 。 不 过 先 别 急 ， 在 开 
始 之 前 我 们 再 来 二 起 看 一 看 ，Android 系 统 到 底 提供 了 哪些 东西 ， 可 供 我 们 
开发 出 优秀 的 应 用 程序 。 


01. 四 大 组 件 


0 


0 


0 


DN 


[S| 


全 


Android 系 统 四 大 组 件 分 别 是 活动 (Activity) 、 服 务 (Service) 、 广 播 
接收 器 (Broadcast Receiver) 和 内 容 提 供 器 (Content Provider) 。 其 中 
活动 是 所 有 Android 应 用 程序 的 门面 ， 凡 是 在 应 用 中 你 看 得 到 的 东西 ， 
都 是 放 在 活动 中 的 。 而 服务 就 比较 低调 了 ， 你 无 法 看 到 它 ， 但 它 会 一 
[在 后 人 台 默 默 地 运行 ， 即 使 用 户 退 出 了 应 用 ， 服 务 仍然 是 可 以 继续 运 
行 的 。 广 播 接 收 絮 允许 你 的 应 用 接收 来 自 各 处 的 广播 消息 ， 比 如 电 

话 、 短 信 等 ， 当 然 你 的 应 用 同样 也 可 以 癌 外 发 出 广播 消息 。 内 容 提 供 
铬 则 为 应 用 程序 之 间 共 享 数 据 提供 了 可 能 ， 比 如 你 想 要 读 取 系统 电话 
短 中 的 联系 人 ， 就 需要 通过 内 容 提供 器 来 实现 。 


mt 


. 丰富 的 系统 控件 


Android 系 统 为 开发 者 提供 了 丰富 的 系统 控件 ， 使 得 我 们 可 以 很 轻松 地 
编写 出 床 亮 的 界面 。 当 然 如 果 你 品位 比较 高 ， 不 满足 于 系统 目 带 的 挖 
件 效果 ， 也 完全 可 以 定制 属于 目 己 的 控件 。 


.SQLite 数 据 库 


Android 系 统 还 自 带 了 这 种 轻 量 级 、 运 算 速 度 极 快 的 嵌入 式 关 系 型 数据 
库 。 它 不 仅 文 持 标准 的 SQL 语法 ， 还 可 以 通过 Android 封 雄 好 的 API 进 行 
操作 ， 证 存储 和 读 取 数据 变 得 非常 方便 。 


. 强大 的 多 媒体 


Android 系 统 还 提供 了 丰富 的 多 娩 体 服务 ， 如 首 乐 、 视 频 、 了 录 首 、 扯 
照 、 闸 铃 ， 等 等 ， 这 一 切 你 都 可 以 在 程序 中 通过 代码 进行 控制 ， 让 你 
的 应 用 变 得 更 加 丰富 多 彩 。 


05. 地 理 位 置 定位 


移动 设备 和 PC 相 比 起 来 ， 地 理 位 置 定位 功能 应 该 可 以 算是 很 大 的 一 个 

亮点 。 现 在 的 Android 手 机 都 内 置 有 GPS， 走 到 哪儿 都 可 以 定位 到 目 己 
的 位 置 ， 发 挥 你 的 想象 就 可 以 做 出 创意 十 足 的 应 用 ， 如 果 再 结合 功能 

强大 的 地 图 功能 ，LBS 这 一 领域 潜力 无 限 。 


既然 有 Android 这 样 出 色 的 系统 给 我 们 提供 了 这 么 丰富 的 工具 ， 你 还 用 担心 
做 不 出 优秀 的 应 用 吗 ? 好 了 ， 纯 理论 的 东西 束 介 绍 到 这 里 ， 我 知道 你 已 经 
迫不及待 想 要 开始 真正 的 开发 之 旅 了 ， 那 我 们 束 开 始 局 程 吧 


1.2 手把手 市 你 搭建 开发 环境 


俗话 说 得 好 ,“ 工 欲 矢 其 事 ， 必 先 利 其 侨 *"， 开 着 记事 本 束 想 去 开发 Android 
程序 显然 不 是 明智 之 举 ， 选 择 一 个 好 的 IDE 可 以 极 大 幅度 地 提高 你 的 开发 效 
率 ， 因 此 本 区 我 束 将 手把手 市 看 你 把 开发 环境 搭建 起 来 。 


1.2.1 准备 所 需要 的 工具 


我 现在 对 你 了 解 还 并 不 多 ， 但 我 希望 你 已 经 是 一 个 磊 有 经 验 的 Java 程 序 员 ， 
这 样 你 理解 本 书 的 内 容 时 将 会 轻而易举 ， 因 为 Android 程 序 都 是 使 用 Java 语 
如 宁 你 对 Java 只 是 略 有 了 解 ， 那 阅读 本 书 应 该 会 有 一 点 困难 ， 不 

一 边 阅 读 一 边 补 充 Java 知 识 也 是 可 以 的 。 但 如 条 你 对 Java 完 全 没有 了 解 ， 
于 和 我 建交 你 可 以 相国 提 本 书 放 下 ”多 买 本 人 绍 Java 基 础 知识 的 书 学 上 两 个 
星期 ， 把 Java 的 基本 语法 和 特性 都 学 会 再 来 继 纪 卖 阅 读 这 本 书 。 


好 了 ， 既 然 你 已 经 阅读 到 这 里 ， 说 明 你 已 经 掌握 Java 的 基本 用 法 了 ， 下 面 我 
们 就 来 看 一 看 开发 Android 程 序 需要 准备 哪些 工具 。 


。 JDK 。 JDK 征 Java 语 吾 于 言 的 软件 开发 工具 包 ， 它 包 含 了 Java 的 运行 环境 、 
工具 集合 、 基 础 类 库 等 内 容 。 需 要 注意 的 是 ， 本 书 中 的 Android 程 序 必 
i 8 或 以 上 版 本 才能 进行 开发 。 


Android SDK 。Android SDK 是 谷歌 提供 的 Android 开 发 工具 包 ， 在 开 
发 Android 程 序 时 ， 我 们 需要 通过 引入 该 工具 包 ， 来 使 用 Android 相 关 的 
API 。 


。 Android Studio 。 在 很 早 之 前 ，Android 项 目 都 是 用 Eclipse 来 开发 的 ， 
相信 所 有 Java 开 发 者 都 一 定 会 对 这 个 工具 非常 熟悉 ， 它 是 Java 开 发 神 
髓 ， 安 装 ADT 搬 件 后 就 可 以 用 来 开发 Android 程 序 了 。 而 在 2013 年 的 时 
候 ， 谷 歌 推出 了 一 款 官 方 的 IDE 工 具 Android Studio， 由 于 不 再 是 以 插件 
的 形式 存在 ，Android Studio 在 开发 Android 程 序 方面 要 远 比 Eclipse 强大 
和 方便 得 多 。 不 过 由 于 Android Studio 早 期 的 测试 版 本 并 不 是 非常 稳 
定 ， 所 以 本 书 的 第 1 版 仍然 选用 Eclipse 来 作为 开发 工具 。 而 如 今 ， 
Android Studio 已 经 推出 了 2.2 版 本 ， 稳 定性 完全 不 再 是 问题 ， 普 及 程度 
方面 也 远 超 Eclipse， 没 有 比 现在 更 适合 的 时 机 来 换 用 Android Studio 
了 ， 因 此 本 书 中 所 有 的 代码 都 将 在 Android Studio 上 进行 开发 。 


1.2.2 ”搭建 开发 环境 


当然 ， 上 述 软 件 并 不 需要 你 去 一 个 个 地 下 载 ， 因 为 谷歌 为 了 简化 搭建 开发 
环境 的 过 程 ， 将 所 有 需要 用 到 的 工具 都 帮 有 我 们 集成 好 了 ， 到 Android 官 网 吏 
可 以 下 载 最 新 的 开发 工具 ， 下 载 地 址 是 : 
https://developer.android.google.cn/studio/index.html 。 不 过 ，Android 官 网 通 
常 都 需要 科学 上 网 才能 访问 ， 如 果 你 无 法 访问 的 话 ， 也 可 以 直接 到 我 的 百 
度 网 盘 去 下 载 ， 下 载 地 址 是 : https://pan.baidu.com/s/1nuABMDb 。 (注意 网 
址 中 是 阿拉 伯 数 字 1， 而 不 是 英文 字母 ]。) 


你 下 载 下 来 的 将 是 一 个 安装 包 ， 安 装 的 过 程 也 很 简单 ， 一 直 点 击 Next 就 可 
以 了 。 其 中 选择 安装 组 件 时 建议 全 部 勾 上 ， 如 图 1.2 所 示 。 


Choose which features of Android Studio you want to install, 


Check the components you want to install and uncheck the components you don't want to 
install. Click Next to continue. 


Select components to install: Android Studio ee 


Position your mouse 


Android SDK over a component to 


Android Virtual Device see its description, 


Space required: 4.8GB 


图 1.2 选择 安装 组 件 


接 下 来 还 会 让 你 选择 Android Studio 的 安装 地 址 以 及 Android SDK 的 安装 地 
址 ， 这 些 根 据 你 自己 电脑 的 实际 情况 选择 就 行 了 ， 不 想 改动 的 话 就 保持 默 
认 ， 如 图 1.3 所 示 。 


Configuration Settings 
Install Locations 


Android Studio Installation Location 


The location specified must have at least 500MB of free space， 
Click Browse to customize: 


C:\Program Files\Android\Android Studio 


Android SDK Installation Location 


The location specified must have at least 3,2GB of free space, 
Click Browse to customize: 


C:\Users\Administrator\AppData\.ocalVAndroid\sdk 


图 1.3 选择 安装 地 址 


后 面 就 没什么 需要 注意 的 了 ， 全 部 保持 默认 项 ， 一 直 点 击 Next 即 可 完成 安 
装 ， 如 图 1.4 所 示 。 


Completing Android Studio Setup 


Android Studio has been installed on your computer， 


Click Finish to dose Setup， 


图 Start Android Studio 


alel rolle 
Slelle 


图 1.4 安装 完成 
现在 点 击 Finish 按 钮 来 启动 Android Studio， 一 开始 会 让 你 选择 是 否 导 入 之 前 
Android Studio 版 本 的 配置 ， 由 于 这 是 我 们 首次 安装 ， 这 里 选择 不 导入 就 可 
以 了 ， 如 图 1.5 所 示 。 


You can import your settings from a previous version of Studio. 
I want to import my settings from a custom locatlon 


Specify config folder or installation home of the previous version of Studio: 


I do not have a previous version of Studio or I do not want to import my settings 


图 1.5 选择 不 导入 配置 
点 击 OK 按 钮 会 进入 到 Android Studio 的 配置 界面 ， 如 图 1.6 所 示 。 


Welcome 


/以 Android Studio 


Welcome back! This setup wizard will validate your current Android SDK and 
development environment setup. You will have the option to download a new Android 
SDK or use an existing installation. Once the setup wizard completes, you can 
import an existing Android app into Android Studio or start a new Android project. 


| CE 
9 |_| UO 


Es | | Next | | Cancel | | Finish 


图 1.6 Android Studio 的 配置 界面 
然后 点 击 Next 开 始 进行 具体 的 配置 ， 如 图 1.7 所 示 。 


A Install Type 


Choose the type of setup you want for Android Studio: 


© Standard 
Android Studio will be installed with the most common settings and options. 
Recommended for most users. 

OO Custom 
You can customize installation settings and components installed. 


Previous | Next | Cancel | | Finish ] 


图 1.7 选择 安装 类 型 


这 里 我 们 可 以 选择 Android Studio 的 安装 类 型 ， 有 Standard 和 Custom 两 种 。 
Standard 表 示 一 切 都 使 用 默认 的 配置 ， 比 较 方便 ;Custom 则 可 以 根据 用 户 的 
特殊 需求 进行 自 定 义 。 简 单 起 见 ， 这 里 我 们 就 选择 Standard 类 型 了 ， 继 续 点 
击 Next 完 成 配置 工作 ， 如 图 1.8 所 示 。 


XXX WAN Saul 


lf you want to review or change any of your installation settings, click Previous. 


Current Settings: 


Setup Type: 
Standard 


SDK Folder 
Ci\Users\Administrator\AppData\Local\Android\Sdk 


ma [re | Loe) 


图 1.8 完成 Android Studio 配 置 


现在 点 击 Finish 按 钮 ， 配 置 工作 就 全 部 完成 了 。 然 后 Android Studio 会 党 试 联 
网 下 载 一 些 更 新 ， 等 待 更 新 完成 后 再 点 击 Finish 按 钮 就 会 进入 Android Studio 
的 欢迎 界面 ， 如 图 1.9 所 示 。 


Androld Studlo 


[= 


天 Start a new Android Studio project 

DD Open an existing Android Studio project 

Check out project from Version Control ~ 
r¥ Import project (Eclipse ADT, Gradle, etc.) 


[¥ Import an Android code sample 


党 Configure vx Get Help ~ 


图 1.9 Android Studio 的 欢迎 界面 


目前 为 止 ，Android 开 发 环境 殉 已 经 全 部 搭建 完成 了 。 那 现在 应 该 做 什么 ? 
当然 是 写 下 你 的 第 一 行 Android 代 码 了 ， 证 我 们 快 点 开始 吧 。 


1.3 ”创建 你 的 第 一 个 Android 项 目 
任何 一 个 编程 语言 写 出 的 第 一 个 程序 训 无 疑问 都 会 是 Hello World， 这 已 经 


征 目 20 世 纪 70 年 代 一 直流 传 下 来 的 传统 ， 在 编程 界 已 成 为 永恒 的 经 典 ， 那 
我 们 当然 也 不 会 搞 例 外 了 。 


1.3.1 ”创建 HelloWorld 项 目 


在 Android Studio 的 欢迎 界面 点 击 Start a new Android Studio project， 会 打开 
一 个 创建 新 项 目的 界面 ， 如 图 1.10 所 示 。 


New Project 


人 Android Studio 


Configure your new project 


Application name: | HelloWorld 
Company Domain: | example.com 
Package name: com.example.helloworld 


口 Include C++ Support 


Project location: Ci\Users\Administrator\AndroidStudioProjects\HelloWorld 


x7] WE Eee 


图 1.10 创建 新 项 目 


其 中 Application name 表 示 应 用 名 称 ， 此 应 用 安装 到 手机 之 后 会 在 手机 上 显 
示 该 名 称 ， 这 里 我 们 填 入 HelloWorld。Company Domain 表 示 公 司 域名 ， 如 
果 是 个 人 开发 者 ， 没 有 公司 域名 的 话 ， 那 么 就 像 我 一 样 填 example.com 就 可 
以 了 。Package name 表 示 项 目的 包 名 ，Android 系 统 丈 是 通过 包 名 来 区 分 不 
同 应 用 程序 的 ， 因 此 包 名 一 定 要 具有 唯一 性 。Android Studio 会 根据 应 用 名 
称 和 公司 域名 来 目 动 帮 我 们 生成 合适 的 包 名 ， 如 果 你 不 想 使 用 默认 生成 的 
包 名 ， 也 可 以 点 击 右 侧 的 Edit 按 钮 目 行 修改 。 最 后 ，Project location 表 示 项 
目 代 码 存 放 的 位 置 ， 如 果 没 有 特殊 要 求 的 话 ， 这 里 也 保持 默认 就 可 以 了 。 


返 下 来 护 击 Next 可 以 对 项 目的 最 低 兼 容 版 本 进行 设置 ， 如 图 1.11 所 示 。 


XXX Target Android Devices 


Select the form factors your app will run on 


Different platforms may require separate SDKs 


Phone and Tablet 
Minimum SDK | ApI 15: Android 4.0.3 (IceCreamSandwich) 图 
Lower Api levels target more devices, but have fewer features available. 


By targeting API 15 and later your app will run on approximately 98.3% of the devices 
that are active on the Google Play Store. 


Help me choose 


Stats load failed. Value may be out of date. 
国 Wear 
Minimum SDK | ApI 21: Android 5.0 (Lollipop) 


口 TV 


Minimum SDK | API 21: Android 5.0 (Lollipop) 


口 Android Auto 
| 355 (Not Available) 


Minimum SDK 


图 1.11 设置 项 目的 最 低 兼容 版 本 


前 面 已 经 说 过 ，Android 4.0 以 上 的 系统 已 经 占据 了 超过 98% 的 Android 市 场 
份额 ， 因 此 这 里 我 们 将 Minimum SDK 指 定 成 API 15 就 可 以 了 。 另 外， 
Wear、TV 和 Android Auto 这 几 个 选项 分 别 是 用 于 开发 可 穿戴 设备 、 电 视 和 
汽车 程序 的 ， 目 前 这 几 个 领域 在 国内 还 没有 普及 ， 我 们 暂时 就 先 包 上 略 吧 。 
en 
1.12 有 所 不。 


Add No Activity 


Fullscreen Activity Google AdMob Ads Activity Google Maps Activity 


图 1.12 选择 模板 


可 以 看 到 ，Android Studio 提 供 了 很 多 种 内 置 模板 ， 不 过 由 于 我 们 才刚 刚 开 
台 学 习 ， 用 不 着 这 么 多 复杂 的 模板 ， 这 里 直接 选择 Empty Activity 来 创建 一 
个 空 的 活动 束 可 以 了 。 


继续 点 击 Next， 可 以 给 创建 的 活动 和 布局 命名 ， 如 图 1.13 所 示 。 


AxX Customize the Activity 


Creates a new empty activity 


Activity Name: | HelloWorldActivity 


Generate Layout File 


Layout Name: | hello_world_layout 
Backwards Compatibility (AppCompat) 


The name of the layout to create for the activity 


图 1.13 给 活动 和 布局 命名 


其 中 ，Activity Name 表 示 活 动 的 名 字 ， 这 里 填 入 HelloWorldActivity，Layonut 
Name 表 示 布 局 的 命名 ， 这 里 填 入 hello_world_layout。 然 后 点 击 Finish 按 钮 ， 
并 耐心 等 待 一 会 儿 ， 项 目 就 会 创建 成 功 了 ， 如 图 1.14 所 示 。 


Ble Eda Vew Navigate Code Analyze Refacor Build Run Tools VCS Window Help 
启 昌 多 YW 小 次 国 全 人 外 人 sppzjPP 浆 少 书 者 国 风 人 G7 
GS Helloworld Capp Dsre DD main’ Djava DD com example © helloworld © HelloWord 
嘱 ' Android ”| 人 名 条 | 章 " I" | 说 heloworld jayoutxml x | @ HelloWorldActivityjava x 
Gapp puckege com ermple helloworl14 
» DD manifests 
v Djava hnmport 
Y comexomple.helloworld 
c © HelloWordActivity o public elass MelloVorlahctivity extoends AppCompathetivit 
» comexample.helloworld (androsdTest 
» comexample.helloworld We 
» Cres 
» (© Gradle Scripts 


y{ 


Ppo ploypuy 这 


国 Terminal ”党 世 Android Monaor ”国立 Messages 时 TODO EventLog ” 国 Gradle Console 
园 Gradle build finished in 26s 325ms (18 minutes ago) 14:1 CRLF: UTF-8: ” 了 生 


图 1.14 项 目 创建 成 功 


1.3.2 ”启动 模拟 器 


由 于 Android Studio 自 动 为 我 们 生成 了 很 多 东西 ， 你 现在 不 需要 编写 任何 代 
码 ，HelloWorld 项 目 就 已 经 可 以 运行 了 。 但 是 在 此 之 前 还 必须 要 有 一 个 运行 
的 载体 ， 可 以 是 一 部 Android 手 机 ， 也 可 以 是 Android 模 拟 器 。 这 里 我 们 暂时 
先 使 用 模拟 器 来 运行 程序 ， 如 果 你 想 立 刻 就 将 程序 运行 到 手机 上 的 话 ， 可 
以 参考 8.1 节 的 内 容 。 


那么 我 们 现在 就 来 创建 一 个 Android 模 拟 器 ， 观 察 Android Studio 顶 部 工具 栏 
中 的 图 标 ， 如 图 1.15 所 示 。 


区 | 对 | 号 


图 1.15 ”顶部 工具 栏 中 的 图 标 


其 中 ， 最 左边 的 按钮 就 是 用 于 创建 和 启动 模拟 器 的 ， 点 击 该 按钮 ， 会 弹出 
如 图 1.16 所 示 的 窗口 。 


页 Android virtual Devi 


Your Virtual Devices 


| 口 一 


/以 Andrond SBI 


Virtual devices allow you to test your application without 
having to own the physical devices. 


十 Create Virtual Device... 


To prioritize which devices to test your application on, visit 
the Android Dashboards, where you can get up-to-date 
information on which devices are active in the Android and 
Google Play ecosystem. 


图 1.16 创建 模拟 器 


可 以 看 到 ， 目 前 我 们 的 模拟 絮 列 表 中 还 是 空 的 ， 点 击 Create Virtual Device 按 
钮 就 可 以 立刻 开始 创建 了 ， 如 图 1.17 所 示 。 


Select Hardware 


Android Studic 


Choose a device definition 


G: ) 
: - = < [DD Nexus 5X 
Category Name ” 


1080px 
Sie: large 
Ratio long 
Density. 4200pi 


1080x1920 
Nexus 4 ya 768x1280 


Galaxy Nexwus 465" 720x1280 
ey 


图 1.17 选择 要 创建 的 模拟 器 设备 


这 里 有 很 多 种 设备 可 供 我 们 选择 ， 不 仅 能 创建 手机 模拟 右 ， 还 可 以 创建 和 
板 、 手 表 、 电 视 等 模拟 器 。 


那么 我 就 选择 创建 Nexus 5X 这 台 设 备 的 模拟 器 了 ， 护 击 Next， 如 图 1.18 所 
示 “。 


System Image 


Android Studio 


Select a system image 


Remmiese x imsges | Other Images 


Release Name API Level ~ 


x86 
These images are recommended because they run 
the fastest and include support for Google Apis 


Questions on APi level? 
See the Apl level distribution chart 


图 1.18 ”选择 模拟 器 的 操作 系统 版 本 


这 里 可 以 选择 模拟 器 所 使 用 的 操作 系统 版 本 ， 毫 无 疑问 ， 我 们 肯定 要 选择 
最 新 的 Android 7.0 系 统 。 继 续 点 击 Next， 如 图 1.19 所 示 。 


elrel[eRVadEEEDN Vs AD 


Android Studio 


Verify Configuration 


AVD Name 
二 AVD Name 


[5 Neww: sx 5.2 1080x1920 420dpi 


The name of this AVD. 


Device Frame Enable Device Frame 


PT PP rp tings | 


Finish 


图 1.19 ”确认 模拟 器 配置 

在 这 里 我 们 可 以 对 模拟 器 的 一 些 配 置 进 行 确认 ， 比 如 说 指定 模拟 器 的 名 
字 、 分 辨 率 、 横 竖 屏 等 信息 ， 如 果 没 有 特殊 需求 的 话 ， 全 部 保持 默认 就 可 
以 了 。 点 击 Finish 完 成 模拟 器 的 创建 ， 然 后 会 弹出 如 图 1.20 所 示 的 窗口 。 


Your Virtual Devices 


人 Android Studio 


Type | Name |Resolution API | Target | CPU/ABI| Size on .| 
加 ] Nexu.. 1080.. 24 Andr.. x86 650 ... 


| 十 Create Virtual Device... 


图 1.20 模拟 器 列表 


可 以 看 到 ， 现 在 模拟 器 列表 中 已 经 存在 一 个 创建 好 的 模拟 器 设备 了 ， 点 击 
Actions 栏 目 中 最 左边 的 三 角形 按钮 即 可 局 动 模拟 右 。 模 拟 融 会 像 手 机 一 
样 ， 有 一 个 开机 过 程 ， 启 动 完成 之 后 的 界面 如 图 1.21 所 示 。 


Google 


加 加 


Gallery 


:Be 


图 1.21 启动 后 的 模拟 器 界面 


很 清新 的 Android 界 面 出 来 了 ! 看 上 去 还 挺 不 错 吧 ， 你 几乎 可 以 像 使 用 手机 
一 样 使 用 它 ，Android 模 拟 器 对 手机 的 模仿 度 非常 高 ， 快 去 体验 一 下 吧 。 


一 一 


1.3.3 ”运作 HellowWorld 


现在 模拟 器 已 经 启动 起 来 了 ， 那 么 下 面 我 们 就 开始 将 HelloWorld 项 目 运 行 到 
模拟 器 上 。 观 察 Android Studio 顶 部 工具 栏 中 的 图 标 ， 如 图 1.22 所 示 。 其 中 
左边 的 锤子 按钮 是 用 来 编译 项 目的 ， 中 间 的 下 拉 列 表 是 用 来 选择 运行 哪 一 
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和 [zapp7™) > 
图 1.22 顶部 工具 栏 中 的 图 标 


现在 点 击 右边 的 运行 按钮 ， 会 弹出 一 个 选择 运行 设备 的 对 话 框 ， 如 图 1.23 所 
示 “。 


忆 
网 Select Deployment Target 


Connected Devices 
Nexus 5X API 24 (Android 7.0, API 24) 


| Create New Virtual Device Don't see your device? 
[DD) Use same selection for future launches [SR | ed | 
“3 Er 上 


图 1.23 选择 运行 设备 对 话 框 


可 以 看 到 ， 我 们 刚刚 创建 的 模拟 器 现在 是 在 线 的 ， 点 击 OK 按 钮 ， 稍 微 等 竺 
一 会 儿 ，HelloWorld 项 目 束 会 运行 到 模拟 器 上 了 ， 结 果 应 该 和 图 1.24 中 显示 
的 是 一 样 的 。 


HelloWorld 


图 1.24 运行 HelloWorld 项 目 


HelloWorld 项 目 运 行 成 功 ! 并 且 你 会 发 现 ， 模 拟 器 上 已 经 安装 上 HelloWorld 
这 个 应 用 了 。 打 开启 动 器 列表 ， 如 图 1.25 所 示 。 


图 1.25 查看 启动 器 列表 


这 个 时 候 你 可 能 会 说 我 坑 你 了 ， 说 好 的 第 一 行 代码 呢 ? 怎 么 一 行 还 没 写 ， 
项 目 就 已 经 运行 起 来 了 ? 这 个 只 能 说 是 因为 Android Studio 太 智能 了 ， 已 经 
帮 我 们 把 一 些 人 简单 内 容 都 自动 生成 了 。 你 也 别 心急 ， 后 面 写 代码 的 机 会 多 
着 呢 ， 我 们 先 来 分 析 一 下 HelloWorld 这 个 项 目 吧 。 


1.3.4 分析 你 的 第 一 个 Android 程 序 


回 到 Android Studio 当 中 ， 首 先 展 开 HelloWorld 项 目 ， 你 会 看 到 如 图 1.26 所 示 
的 项 目 结 构 。 


虽 , Android 全 站 | 内 I 
C3app 
四 manifests 
四 java 
Cares 
全 Gradle Scripts 
(© build.gradle (Project: HelloWorld) 
(® build.gradle (Module: app) 
[i gradle-wrapper.properties (Gradle Version) 


目 proguard-rules.pro (ProGuard Rules for app) 
[i gradle.properties (Project Properties) 
(© settings.gradle (Project Settings) 


[i local.properties (SDK Location) 


图 1.26 ”Android 模 式 的 项 目 结构 


任何 一 个 新 建 的 项 目 都 会 默认 使 用 Android 模 式 的 项 目 结构 ， 但 这 并 不 是 项 
目 真实 的 目录 结构 ， 而 是 被 Android Studio 转 换 过 的 。 这 种 项 目 结构 简洁 明 
了 ， 适 合 进行 快速 开发 ， 但 是 对 于 新 手 来 说 可 能 并 不 易于 理解 。 点 击 图 1.26 
当中 的 Android 区 域 可 以 切换 项 目 结构 模式 ， 如 图 1.27 所 示 。 


| 过 Android ” 


Packages 


Scratches 
Android 
Project Files 
Problems 
Production 
Tests 


Tests 


Android Instrumentation Tests 


图 1.27 切换 项 目 结构 模式 


这 里 我 们 将 项 目 结构 模式 切换 成 Project， 这 就 是 项 目 真实 的 目录 结构 了 ， 如 
图 1.28 所 示 。 


BB Project ™ 全 | 并 -1 
Ez HelloWorld Ci\Users\Administrator\AndroidStud 
DD .gradle 
户 .idea 
加 app 
DD build 
四 gradle 
[a] .gitignore 
(© build.gradle 
dM gradle.properties 
目 gradlew 
=| gradlew.bat 
加 HelloWorld.iml 
[i local.properties 


(® settings.gradle 


图 1.28 ”Project 模 式 的 项 目 结构 

一 开始 看 到 这 么 多 陌生 的 东西 ， 你 一 定 会 感到 有 点 头晕 吧 。 别 担心 ， 我 现 
在 就 对 图 1.28 中 的 内 容 进行 一 一 讲解 ， 之 后 你 再 看 这 张 图 就 不 会 感到 那么 吃 
为 了 

01. .gradle 和 .idea 


这 两 个 目录 下 放置 的 都 是 Android Studio 自 动 生成 的 一 些 文件 ， 我 们 无 
须 关 心 ， 也 不 要 去 手动 编辑 。 


02. app 
项 目 中 的 代码 、 资 源 等 内 容 几 乎 都 是 放置 在 这 个 目录 下 的 ， 我 们 后 面 
的 开发 工作 也 基本 都 是 在 这 个 目录 下 进行 的 ， 待 会 儿 还 会 对 这 个 目录 
单独 展开 进行 讲解 。 

03. build 


i ee 它 主 要 包含 了 一 些 在 编译 时 目 动 生成 


04. gradle 


这 个 目录 下 包含 了 gradle wrapper 的 配置 文件 ， 使 用 gradle wrapper 的 方 
式 不 需要 提前 将 gradle 下 载 好 ， 而 是 会 自动 根据 本 地 的 缓存 情况 决定 是 


0 


0 


0 


0 


0 


1 


1 


5: 


Oo 


7. 


Co 


CD 


© 


—_ 


否 需要 联网 下 载 gradle。Android Studio 上 默认 没有 启用 gradle wrapper 的 方 
式 ， 如 果 需 要 打开 ， 可 以 点 击 Android Studio 导 航 栏 

=> File =» Settings ~ Build, Execution, Deployment - Gradle， 进 行 配置 更 
改 。 


.gitignore 


这 个 文件 是 用 来 将 指定 的 目录 或 文件 排除 在 版 本 控制 之 外 的 ， 关 于 版 
本 控制 我 们 将 在 第 5 章 中 开始 正式 的 学 习 。 


.build.gradle 


这 是 项 目 全 局 的 gradle 构 建 肢 本， 通常 这 个 文件 中 的 内 容 是 不 需要 修改 
的 。 稍 后 我 们 将 会 详细 分 析 gradle 构 建 脚本 中 的 具体 内 容 。 


gradle.properties 


这 个 文件 是 全 局 的 gradle 配 置 文件 ， 在 这 里 配置 的 属性 将 会 影响 到 项 目 
中 所 有 的 gradle 编 译 脚 本 。 


. gradlew 和 gradlew.bat 


这 两 个 文件 是 用 来 在 命令 行 界面 中 执行 gradle 命 令 的 ， 其 中 gradlew 是 在 
Linux 或 Mac 系 统 中 使 用 的 ，gradlew.bat 是 在 Windows 系 统 中 使 用 的 。 


. HelloWorld.iml 


iml 文 件 是 所 有 Intellij IDEA 项 目 都 会 自动 生成 的 一 个 文件 (Android 
Studio 是 基于 IntelliJ IDEA 开 发 的 ) ， 用 于 标识 这 是 一 个 IntelliJ IDEA 项 
目 ， 我 们 不 需要 修改 这 个 文件 中 的 任何 内 容 。 


. local.properties 


这 个 文件 用 于 指定 本 机 中 的 Android SDK 路 径 ， 通 常 内 容 都 是 自动 生成 
的 ， 我 们 并 不 需要 修改 。 除 非 你 本 机 中 的 Android SDK 位 置 发 生 了 变 
化 ， 那 么 加 将 这 个 文件 中 的 路 径 改 成 新 的 位 置 即 可 。 


. Settings.gradle 


这 个 文件 用 于 指定 项 目 中 所 有 3 引入 的 模块 。 由 于 HelloWorld 项 目 中 就 只 
有 一 个 app 模 块 ， 因 此 该 文件 中 也 束 只 引入 了 app 这 一 个 模块 。 通 常情 


况 下 模块 的 引入 都 是 目 动 完成 的 ， 需 要 我 们 手动 去 修改 这 个 文件 的 场 


景 可 能 比较 少 。 


现在 整个 项 目的 外 层 目 孙 结 构 已 经 介绍 完了 。 你 会 发 现 ， 除 了 app 目 录 之 
外 ， 大 多 数 的 文件 和 目录 都 是 自动 生成 的 ， 我 们 并 不 需要 进行 修改 。 想 必 
1 app 目 录 下 的 内 容 才 是 我 们 以 后 的 工作 重点 ， 展 开 之 后 结构 
如 图 1.29 所 示 。 


Ci app 
四 build 
口 libs 
户 src 
四 androidTest 
四 main 
四 java 
Cares 
Ba AndroidManifest.xml 
Dtest 
目 .gitignore 
app.iml 
(5 build.gradle 


目 proguard-rules.pro 


图 1.29 app 目 录 下 的 结构 
那么 下 面 我 们 束 来 对 app 目 孙 下 的 内 容 进 行 更 为 详细 的 分 析 。 
01. build 


这 个 目录 和 外 层 的 build 目 录 类 似 ， 主 要 也 是 包含 了 一 些 在 编译 时 目 动 
生成 的 文件 ， 不 过 它 里 面 的 内 容 会 更 多 更 杂 ， 我 们 不 需要 过 多 关心 。 


02. libs 


如 果 你 的 项 目 中 使 用 到 了 第 三 方 jar 包 ， 就 需要 把 这 些 jar 包 都 放 在 libs 目 
录 下 ， 放 在 这 个 目录 下 的 jar 包 都 会 被 目 动 添加 到 构建 路 径 里 去 。 


03. androidTest 


此 处 是 用 来 编写 Android Test 测 试用 例 的 ， 可 以 对 项 目 进行 一 些 目 动 化 
测试 。 


04. java 


训 无 疑问 ，java 目 录 是 放置 我 们 所 有 Java 代 码 的 地 方 ， 展 开 该 目 示 ， 你 
将 看 到 我 们 刚才 创建 的 HelloWorldActivity 文 件 就 在 里 面 。 


05. res 


这 个 目录 下 的 内 容 束 有 点 多 了 。 简 单 点 说 ， 就 是 你 在 项 目 中 使 用 到 的 
所 有 图 片 、 布 局 、 字 符 串 等 资源 都 要 存放 在 这 个 目录 下 。 当 然 这 个 目 
录 下 还 有 很 多 子 目 录 ， 图 片 放 在 drawable 目 录 下 ， 布 局 放 在 layout 目 录 
eh 串 放 在 values 目 了 永 下 ， 所 以 你 不 用 担心 会 把 整个 res 目 了 永 弄 得 乱 


06. AndroidManifest.xml 


这 是 你 整个 Android 项 目的 配置 文件 ， 你 在 程序 中 定义 的 所 有 四 大 组 件 
都 需要 在 这 个 文件 里 注册 ， 另 外 还 可 以 在 这 个 文件 中 给 应 用 程序 添加 
i 我 们 用 到 的 时 候 再 做 详细 
说 明 。 


07. test 


此 处 是 用 来 编写 Unit Test 测 试用 例 的 ， 征 对 项 目 进行 目 动 化 测试 的 兄 一 
种 方式 。 


0 


Co 


. .gitignore 


这 个 文件 用 于 将 app 模 块 内 的 指定 的 目录 或 文件 排除 在 版 本 控制 之 外 ， 
作用 和 外 层 的 .gitignore 文 件 类 似 。 


09. app.iml 


0 
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.build.gradle 


这 是 app 模 块 的 gradle 构 建 脚本 ， 这 个 文件 中 会 指定 很 多 项 目 构建 相关 
的 配置 ， 我 们 稍 后 将 会 详细 分 析 gradle 构 建 脚 本 中 的 具体 内 容 。 


1 


(em 


11. proguard-rules.pro 


这 个 文件 用 于 指定 项 目 代码 的 混 清 规则， 当代 码 开发 完成 后 打 成 安 效 
包 文件 ， 如 采 不 布 望 代码 被 别人 破解 ， 通 间 会 将 代码 进行 混 消 ， 从 而 
让 破解 者 难以 阅读 。 


这 样 整 个 项 目的 目录 结构 束 都 介绍 完了 ， 如 果 你 还 不 能 完全 理解 的 话 也 很 
正常 ， 上 毕竟 里 面 有 太 多 的 东西 你 都 还 没 接触 过 。 不 过 不 用 担心 ， 这 并 不 会 
影响 到 你 后 面 的 学 习 。 等 你 学 完整 本 书 再 回来 看 这 个 目录 结构 图 时 ， 你 会 
觉得 特别 地 清晰 和 简单 。 


接 下 来 我 们 一 起 分 析 一 下 HelloWorld 项 目 究 竟 是 怎么 运行 起 来 的 吧 。 首 先 打 
开 AndroidManifest.xml 文 件 ， 从 中 可 以 找到 如 下 代码 : 


<activity android:name=".HelloworldActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 


</intent-filter> 
</activity> 


这 段 代 码 表示 对 HelloWorldActivity 这 个 活动 进行 注册 ， 没 有 在 
AndroidManifest.xml 里 注册 的 活动 是 不 能 使 用 的 。 其 中 intent-filter 里 的 
两 行 代码 非常 重要 ，<action android:name= 
"android,.intent.action.MAIN" /> 和 <category 
android:name="android.intent.category.LAUNCHER" /> 表示 
HelloWorldActivity 是 这 个 项 目的 主 活动 ， 在 手机 上 点 击 应 用 图 标 ， 首 先 局 
动 的 就 是 这 个 活动 。 


那 HelloWorldActivity 具 体 又 有 什么 作用 呢 ? 我 在 介绍 Android 四 大 组 件 的 时 
候 说 过 ， 活 动 是 Android 应 用 程序 的 | 门面， 凡是 在 应 用 中 你 看 得 到 的 东西 ， 
都 是 放 在 活动 中 的 。 因 此 你 在 图 1.24 中 看 到 的 界面 ， 其 实 束 十 
HelloWorldActivity 这 个 活动 。 那 我 们 快 去 看 一 下 它 的 代码 吧 ， 打 开 
HelloWorldActivity， 代 码 如 下 所 示 : 


public class HelloworldActivity extends AppCompatActivity { 


QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedIinstanceState); 
setcontentView(R.1layout.hello world_ layout); 


} 


| | 


首先 我 们 可 以 看 到 ，HelloworldActivity 是 继承 目 AppCompatActivity 的 ， 这 
是 一 种 向 下 兼容 的 Activity， 可 以 将 Activity 在 各 个 系统 版 本 中 增加 的 特性 和 
功能 最 低 兼 容 到 Android 2.1 系 统 。Activity 是 Android 系 统 提 供 的 一 个 活动 基 
类 ， 我 们 项 目 中 所 有 的 活动 都 人 须 继 承 它 或 者 它 的 子 类 才能 拥有 活动 的 特 
性 (AppcompatActivity 是 Activity 的 子 类 ) 。 然 后 可 以 看 到 
HelloWorldActivity 中 有 一 Noncreate() 方法 ， 这 个 方法 是 一 个 活动 被 创建 
时 必定 要 执行 的 方法 ， 其 中 只 有 两 行 代码 ， 并 且 没有 Hello World! 的 字样 。 
那么 图 1.24 中 显示 的 Hello World! 是 在 哪里 定义 的 呢 ? 


其 实 Android 程 序 的 设计 讲究 逻辑 和 视图 分 离 ， 因 此 是 不 推荐 在 活动 中 直接 
编写 界面 的 ， 更 加 通用 的 一 种 做 法 是 ， 在 布局 文件 中 编写 界面 ， 然 后 在 活 
动 中 引入 进来 。 可 以 看 到 ， 在 oncreate() 方法 的 第 二 行 调 用 了 
setContentView() 方法 ， 束 是 这 个 方法 给 当前 的 活动 引入 了 一 个 
hello_world_layout 布 局 ， 那 Hello World! 一 定 就 是 在 这 里 定义 的 了 ! 我 们 快 
打开 这 个 文件 看 一 看 。 


布局 文件 都 是 定义 在 res/layout 目 录 下 的 ， 当 你 展开 layout 目 录 ， 你 会 看 到 
hello_world_layout.xml 这 个 文件 。 打 开 该 文件 并 切换 到 Text 视 图 ， 代 码 如 下 
所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:id="@+id/hello_world_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:paddingBottom="@dimen/activity_vertical margin" 
android:paddingLeft="@dimen/activity_horizontal margin" 
android:paddingRight="@dimen/activity_horizontal_ margin" 
android:paddingTop="@dimen/activity_vertical margin" 
tools:context="com.example.helloworld.HelloworldActivity"> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="Hello World!" /> 
</RelativeLayout> 


现在 还 看 不 懂 ? 没关系 ， 后 面 我 会 对 布局 进行 详细 讲解 的 ， 你 现在 只 需要 
看 到 上 面 代 码 中 有 一 个 TextView， 这 是 Android 系 统 提供 的 一 个 控件 ， 用 于 
在 布局 中 显示 文字 的 。 然 后 你 终于 在 TextView 中 看 到 了 Hello World! 的 字 


样 ! 哈哈 ! 终于 找到 了 ， 原 来 束 是 通过 android:text="Hello World!" 这 人 句 
代码 定义 的 。 


这 样 我 们 就 将 HelloWorld 项 目的 目录 结构 以 及 基本 的 执行 过 程 都 分 析 完 了 ， 
相信 你 对 Android 项 目 已 经 有 了 一 个 初步 的 认识 ， 下 一 小 节 中 我 们 就 来 学 习 
一 下 项 目 中 所 包含 的 资源 。 


1.3.5 ”详解 项 目 中 的 资源 


如 果 你 展开 res 目 孙 看 一 下 ， 其 实 里 面 的 东西 还 是 挺 多 的 ， 很 容易 让 人 看 得 
眼 花 综 乱 ， 如 图 1.30 所 示 。 


[C3 res 
加 drawable 
后 layout 
加 mipmap-hdpi 
思 mipmap-mdpi 
DD mipmap-xhdpi 
加 mipmap-xxhdpi 
[© mipmap-xooxhdpi 
加 values 
思 values-w820dp 


图 1.30 res 目录 下 的 结构 


看 到 这 么 多 的 文件 夹 也 不 用 害怕 ， 其 实 归纳 一 下 ，res 目 录 就 变 得 非常 简单 
了 。 所 有 以 drawable 开 头 的 文件 夹 都 是 用 来 放 图 片 的 ， 所 有 以 mipmap 开 头 
的 文件 夹 都 是 用 来 放 应 用 图 标的 ， 所 有 以 values 开 头 的 文件 夹 都 是 用 来 放 字 
符 串 、 样 式 、 颜 色 等 配置 的 ，layout 文 件 夹 是 用 来 放 布 局 文件 的 。 怎 么 样 ， 


征 不 是 突然 感觉 清晰 了 很 多 ? 


之 所 以 有 这 么 多 mipmap 开 头 的 文件 夹 ， 其 实 主要 是 为 了 让 程序 能 够 更 好 地 
兼容 各 种 设备 。drawable 文 件 夹 也 是 相同 的 道理 ,里 然 Android Studio 没 有 帮 
我 们 目 动 生 成 ， 但 是 我 们 应 该 目 己 创建 drawable-hdpi、drawable-xhdpi、 
drawable-xxhdpi 等 文件 夹 。 在 制作 程序 的 时 候 最 好 能 够 给 同一 张 图 片 提 供 几 
个 不 同 分 辨 紊 的 版 本 ,分别 放 在 这 些 文件 来 下 ， 然 后 当 程序 运行 的 时 候 ， 

会 目 动 根据 当前 运行 设备 分 辨 率 的 高 低 选 择 加 载 哪 个 文件 夹 下 的 图 片 。 当 
然 这 只 是 理想 情况 ， 更 多 的 时 候 美 工 只 会 提供 给 我 们 一 份 图 片 ， 这 时 你 残 
把 所 有 图 片 都 放 在 drawable-xxhdpi 文 件 夹 下 就 好 了 。 


吧 。 打 开 res/ values/strings.xml 文 件 ， 内 容 如 下 所 示 : 


<resources> 
<string name="app_name">Helloworld</string> 
</resources> 


0 这 里 定义 了 一 个 应 用 程序 名 的 字符 串 ， 我 们 有 以 下 两 种 方式 来 
| 


加 在 代码 中 通过 R. string.app_name 可 以 获得 该 字符 串 的 引用 。 
。 在 XML 中 通过 @string/app_name 可 以 获得 该 字符 串 的 引用 。 

基本 的 语法 就 是 上 面 这 两 种 方式 ， 其 中 string 部 分 是 可 以 替换 的 ， 如 果 是 

引用 的 图 片 资源 就 可 以 替换 成 drawable ， 如 果 是 引用 的 应 用 图 标 就 可 以 蔡 

换 成 mipmap ， 如 果 是 引用 的 布局 文件 就 可 以 苦 换 成 layout ， 以 此 类 推 。 


下 面 举 一 个 简单 的 例子 来 帮助 你 理解 ， 打 开 AndroidManifest.xml 文 件 ， 找 到 
如 下 代码 : 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 


其 中 ，Helloworld 项 目的 应 用 图 标 就 是 通过 android: icon 属性 来 指定 的 ， 应 
用 的 名 称 则 是 通过 android:1abel 属性 指定 的 。 可 以 看 到 ， 这 里 对 资源 引用 
的 方式 正 是 我 们 刚刚 学 过 的 在 XML 中 引用 资源 的 语法 。 


经 过 本 小 节 的 学 习 ， 如 采 你 想 修 改 应 用 的 图 标 或 者 名 称 ， 相 信 已 经 知道 该 
二 


1.3.6 ”详解 build.gradle 文 件 


不 同 于 Eclipse，Android Studio 是 采用 Gradle 来 构建 项 目的 。Gradle 是 一 个 非 
常 完 进 的 项 目 构 建 工 具 ， 它 使 用 了 一 种 基于 Groovy 的 领域 特定 语言 

(DSL) 来 声明 项 目 设 置 ， 握 弃 了 传统 基于 XML (如 Ant 和 Maven) 的 各 种 
烦琐 配置 


在 1.3.4 小 和 中 我 们 已 经 看 到 ，Helloworld 项 目 中 有 两 个 build.gradle 文 件 ， 一 
个 是 在 最 外 层 目录 下 的 ， 一 个 是 在 app 目 永 下 的 。 这 两 个 文件 对 构建 Android 
Studio 项 目 都 起 到 了 人 至 天 重要 的 作用 ， 下 面 我 们 就 来 对 这 两 个 文件 中 的 内 容 
进行 详细 的 分 析 。 


先 来 看 一 下 最 外 层 目 录 下 的 build.gradle 文 件 ， 代 码 如 下 所 示 : 


buildscript { 
repositories { 
jcenter() 


} 
dependencies 
classpath "com.android,tools.build:gradle:2.2.0' 
} 


allprojects { 
repositories { 
jcenter() 


这 些 代码 都 是 自动 生成 的 ， 虽然 语法 结构 看 上 去 可 能 有 点 难以 理解 ， 但 是 
如 采 我 们 名 略语 法 结构 ， 只 看 最 关键 的 部 分 ， 其 实 还 是 很 好 懂 的 。 


首先 ， 两 处 repositories 的 闭 包 中 都 声明 了 jcenter() 这 行 配 置 ， 那 么 这 个 
jcenter 是 什么 意思 呢 ? 其 实 它 是 一 个 代码 托管 仓库 ， 很 多 Android 开 源 项 目 
都 会 选择 将 代码 托管 到 jcenter 上 ， 声 明了 这 行 配置 之 后 ， 我 们 束 可 以 在 项 目 
中 轻松 引用 任何 jcenter 上 的 开源 项 目 了 。 


接 下 来 ，dependencies 闭 包 中 使 用 classpath 声明 了 一 个 Gradle 插 件 。 为 什 
么 要 声明 这 个 插件 呢 ? 因为 Gradle 并 不 是 专门 为 构建 Android 项 目 而 开发 

的 ，Java、C++ 等 很 多 种 项 目 都 可 以 使 用 Gradle 来 构建 。 因 此 如 果 我 们 要 想 
使 用 它 来 构建 Android 项 目 ， 则 需要 声明 
com.android.tools.build:gradle:2.2.0 这 个 插件 9 其 中 ， 最 后 面 的 部 分 是 


插件 的 版 本 号 ， 我 在 写作 本 书 时 最 新 的 插件 版 本 是 2.2.0。 


这 样 我 们 就 将 最 外 层 目录 下 的 build.gradle 文 件 分 析 完 了 ， 通 常情 况 下 你 并 不 
需要 修改 这 个 文件 中 的 内 容 ， 除 非 你 想 添 加 一 些 全 局 的 项 目 构 建 配置 。 


下 面 我 们 再 来 看 一 下 app 目 录 下 的 build.gradle 文 件 ， 代 码 如 下 所 示 : 


apply plugin: "com.android.application' 


android { 

compileSdkVversion 24 

buildToolsVersion "24.0.2" 

defaultConfig { 
applicationId "com.example.helloworld" 
minSsdkVersion 15 
targetSsdkVersion 24 
versionCode 1 
versionName "1.0" 


} 
buildTypes { 
release { 
minifyEnabled false 
proguardFiles getDefaultProguardFile('proguard-android.txt'), 
"proguard-rules.pro' 


} 
} 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android.support:appcompat-v7:24.2.1" 
testCompile 'junit:junit:4.12"' 

} 


这 个 文件 中 的 内 容 就 要 相对 复杂 一 些 了 ， 下 面 我 们 一 行 行 地 进行 分 析 。 首 
先 第 一 行 应 用 了 一 个 插件 ， 一 般 有 两 种 值 可 选 : com.android.application 
表示 这 是 一 个 应 用 程序 模块 ，com.android.1ibrary 表示 这 是 一 个 库 模 块 。 
应 用 程序 模块 和 库 模 块 的 最 大 区 别 在 于 ， 一 个 是 可 以 直接 运行 的 ， 一 个 只 
能 作为 代码 库 依附 于 别 的 应 用 程序 模块 来 运行 。 


接 下 来 是 一 个 大 的 android 闭 包 ， 在 这 个 闭 包 中 我 们 可 以 配置 项 目 构建 的 各 
种 属性 8 其 中 ， compileSdkVersion 用 于 指定 项 日 的 编译 版 本 ， 这 里 指定 成 
24 表 示 使 用 Android 7.0 系 统 的 SDK 编 译 。buildToolsversion 用 于 指定 项 目 
构建 工具 的 版 本 ， 目 前 最 新 的 版 本 就 是 24.0.2， 如 果 有 更 新 的 版 本 时 ， 
Android Studio 会 进行 提示 。 


然后 我 们 看 到 ， 这 里 在 android 闭 包 中 叉 髓 套 了 一 个 defaultConfig 闭 包 ， 
defaultConfig 闭 包 中 可 以 对 项 目的 更 多 细 和 进行 配置 。 其 中 ，applicationId 
用 于 指定 项 目的 包 名 ， 前 面 我 们 在 创建 项 目的 时 候 其 实 已 经 指定 过 包 名 

了 ， 如 果 你 想 在 后 面 对 其 进行 修改 ， 那 么 就 是 在 这 里 修改 的 。 


minsdkversion 用 于 指定 项 目 最 低 兼 容 的 Android 系 统 版 本 ， 这 里 指定 成 15 表 
示 最 低 兼 容 到 Android 4.0 系 统 。targetsdkversion 指定 的 值 表 示 你 在 该 目标 
版 本 上 已 经 做 过 了 充分 的 测试 ， 系 统 将 会 为 你 的 应 用 程序 启用 一 些 最 新 的 
功能 和 特性 。 比 如 说 Android 6.0 系 统 中 引入 了 运行 时 权限 这 个 功能 ， 如 果 你 
将 targetsdkversion 指定 成 23 或 者 更 高 ， 那 么 系统 歼 会 为 你 的 程序 启用 运 
行 时 权限 功能 ， 而 如 果 你 将 targetsdkversion 指定 成 22， 那 么 就 说 明 你 的 
程序 最 高 只 在 Android 5.1 系 统 上 做 过 充分 的 测试 ，Android 6.0 系 统 中 引入 的 
新 功能 自然 陇 不 会 启用 了 。 剩 下 的 两 个 属性 都 比较 简单 ， versioncode 用 于 
指定 项 目的 版 本 号 ，versionName 用 于 指定 项 目的 版 本 名 ， 这 两 个 属性 在 生 
成 安装 文件 的 时 候 非常 重要 ， 我 们 在 后 面 都 会 学 到 。 


分 析 完 了 defaultConfig 闭 包 ， 接 下 来 我 们 看 一 下 buildTypes 闭 包 。 
buildTypes 闭 包 中 用 于 指定 生成 安装 文件 的 相关 配置 ， 通 常 只 会 有 两 个 子 闭 
包 ， 一 个 是 debug， 一 个 是 release。 debug 闭 包 用 于 指定 生成 测试 版 安装 文件 
的 配置 ，release 闭 包 用 于 指定 生成 正式 版 安装 文件 的 配置 。 男 外 ，debug 闭 
包 是 可 以 忽略 不 写 的 ， 因 此 我 们 看 到 上 面 的 代码 中 就 只 有 一 个 release 闭 包 。 
下 面 来 看 一 下 release 闭 包 中 的 具体 内 容 吧 ， minifyEnabled 用 于 指定 是 否 对 
项 目的 代码 进行 混淆 ，true 表示 混淆，false 表示 不 混 消 。proguardFiles 
用 于 指定 混 消 时 使 用 的 规则 文件 ， 这 里 指定 了 两 个 文件 ， 第 一 个 proguard- 
android.txt 是 在 Android SDK 目 孙 下 的 ， 里 面 是 所 有 项 目 通用 的 混 请 规 
则 ， 第 二 个 proguard-rules.pro 是 在 当前 项 目的 根 日 录 下 的 ， 里 面 可 以 编 
写 当 前 项 目 特 有 的 混 消 规则 。 需 要 注意 的 是 ， 通 过 Android Studio 直 接 运 行 
项 目 生 成 的 都 是 测试 版 安装 文件 ， 关 于 如 何 生成 正式 版 安装 文件 我 们 将 会 
在 第 15 章 中 学 习 。 


这 样 整个 android 财 包 中 的 内 容 就 都 分 析 完 了 ， 接 下 来 还 剩 一 个 dependencies 
闭 包 。 这 个 闭 包 的 功能 非常 强大 ， 它 可 以 指定 当前 项 目 所 有 的 依赖 关系 。 
通 解 Android Studio 项 目 一 共有 3 种 依赖 方式 : 本 地 依赖 、 库 依赖 和 远程 依 
赖 。 本 地 依赖 可 以 对 本 地 的 Jar 包 或 目录 添加 依赖 天 系 ， 库 依赖 可 以 对 项 目 
中 的 库 模 块 添加 依赖 天 系 ， 远 程 依赖 则 可 以 对 jcenter 库 上 的 开源 项 目 添 加 依 
赖 关 系 。 观 察 一 下 dependencies 团 包 中 的 配置 ， 第 一 行 的 compile fileTree 
就 是 一 个 本 地 依赖 声明 ， 它 表示 将 libs 目 录 下 所 有 .jar 后 级 的 文件 都 添加 到 项 
目的 构建 路 径 当 中 。 而 第 二 行 的 compile 则 是 远程 依赖 声明 ， 
com.android.support:appcompat-v7:24.2.1 束 是 一 个 标准 的 远程 依赖 库 格 
式 ， 其 中 com.android.support 是 域名 部 分 ， 用 于 和 其 他 公司 的 库 做 区 分 ; 
appcompat -v7 是 组 名 称 ， 用 于 和 同一 个 公司 中 不 同 的 库 做 区 分 ，24.2.1 是 版 
本 号 ， 用 于 和 同一 个 库 不 同 的 版 本 做 区 分 。 加 上 这 人 句 声 明 后 ，Gradle 在 构建 
项 目 时 会 首先 检查 一 下 本 地 是 否 已 经 有 这 个 库 的 缓存 ， 如 果 没 有 的 话 则 会 


去 目 动 联网 下 载 ， 然 后 再 添加 到 项 目的 构建 路 径 当 中 。 至 于 库 依 赖 声 明 这 


里 没有 用 到 ， 它 的 基本 格式 是 compile project 后 面 加 上 要 依赖 的 库 名 称 


、\， 


比如 说 有 一 个 库 模 块 的 名 字 叫 helper， 那 么 添加 这 个 库 的 依赖 关系 只 需要 加 


入 compile project(':helper' ) 这 人 句 声 明 即 可 。 另外 剩 下 的 一 人 名 
testcompile 是 用 于 声明 测试 用 例 库 的 ， 这 个 我 们 暂时 用 不 到 ， 先 忽略 
可 以 了 。 


它 就 


1.4 前 行 必 备 一 一 掌握 日 志 工具 的 使 用 


通过 上 一 节 的 学 习 ， 你 已 经 成 功 创建 了 你 的 第 一 个 Android 程 序 ， 并 且 对 


人 目的 目录 结构 和 运行 流程 都 有 了 一 定 的 了 解 。 现 在 本 应 该 是 你 继 
续 前 行 的 时 候 ， 不 过 我 想 在 这 里 给 你 穿插 一 点 内 容 ， 讲 解 一 下 Android 中 日 


志 工 具 的 使 用 方法 ， 这 对 你 以 后 的 Android 开 发 之 旅 会 有 极 大 的 帮助 。 
1.4.1 使 用 Android 的 日 志 工 具 Log 


Android 中 的 日 志 工 具 类 是 Log (android.util.Log) ， 这 个 类 中 提供 了 如 下 5 


个 方法 来 供 我 们 打印 日 志 。 


。 Log.v() 。 用 于 打印 那些 最 为 琐 雁 的 、 意 义 最 小 的 日 志 信 息 。 对 应 级 别 


verbose， 是 Android 日 志 里 面 级 别 最 低 的 一 种 。 


。 Log.d() 。 用 于 打印 一 些 调试 信息 ， 这 些 信息 对 你 调试 程序 和 分 析 问 题 


应 该 是 有 帮助 的 。 对 应 级 别 debug， 比 verbose 高 一 级 。 


。 Log.i() 。 用 于 打印 一 些 比较 重要 的 数据 ， 这 些 数 据 应 该 是 你 非常 想 看 
到 的 、 可 以 帮 你 分 析 用 户 行为 数据 。 对 应 级 别 info， 比 debug 局 一 级 。 


。Log.w()。 用 于 打印 一 些 警 告 信息 ， 提 示 程 序 在 这 个 地 方 可 能 会 有 潜在 
的 风险 ， 最 好 去 修复 一 下 这 些 出 现 警告 的 地 广 。 对 应 级 别 warn， 比 info 


高 一 级 。 


。 Log.e() 。 用 于 打印 程序 中 的 错误 信息 ， 比 如 程序 进入 到 了 catch 语 句 当 
中 。 当 有 错误 信息 打印 出 来 的 时 候 ， 一 般 都 代表 你 的 程序 出 现 严重 问 


题 了 ， 必 须 尽 快 修复 。 对 应 级 别 error， 比 warn 高 一 级 。 


其 实 很 简单 ， 一 共 束 5 个 方法 ， 当 然 每 个 方法 还 会 有 不 同 的 重 载 ， 但 那 对 你 
来 说 肯定 不 是 什么 难 理解 的 地 方 了 。 我 们 现在 吏 在 HelloWorld 项 目 中 试 一 试 
日 志 工 具 好 不 好 用 吧 。 


打开 HelloworldActivity， 在 oncreate() 方法 中 添加 一 行 打印 日 志 的 语句 ， 
如 下 所 示 : 


protected void onCreate(Bundle SavedInstanceState) { 
super .onCreate(savedIinstanceState); 
setcontentView(R.1layout.hello world_ layout); 
Log.d("HelloworldActivity", "onCreate execute"); 


Log.d() 方法 中 传 入 了 两 个 参数 ， 第 一 个 参数 是 tag ， 一 般 传 入 当前 的 类 名 
束 好 ， 主 要 用 于 对 打印 信息 进行 过 滤 ; 第 二 个 参数 是 msg ， 即 想 要 打印 的 具 
体 的 内 容 。 


现在 可 以 重新 运行 一 下 HelloWorld 这 个 项 目 了 ， 点 击 顶 部 工具 栏 上 的 运行 按 
钮 ， 或 者 使 用 快捷 键 Shift + F10 (Mac 系 统 是 control + R) ， 等 程序 运行 完 
毕 ， 点 击 Android Studio 底 部 工具 栏 的 Android Monitor， 在 logcat 中 就 可 以 看 
到 打印 信息 了 ， 如 图 1.31 所 示 。 


Android Monitor 次 二 
Emulator Nexus_5X_API_24 图 com.examplehelloworld | 

WE | yx logcat | Monitors »" Verbose | ronCreate Regex | Show only selected application | 
已 
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图 1.31 logcat 中 的 打印 信息 


其 中 ， 你 不 仅 可 以 看 到 打印 日 志 的 内 容 和 tag 名 ， 就 连 程序 的 包 名 、 打 印 的 
时 间 以 及 应 用 程序 的 进程 号 都 可 以 看 到 。 


另外 ， 不 知道 你 有 没有 注意 到 ， 你 的 第 一 行 代 码 已 经 在 不 知 不 觉 中 写 出 来 
了 ， 我 也 总 算是 交卷 了 。 


1.4.2 ”为 什么 使 用 Log 而 不 使 用 System.out 


我 相信 很 多 的 Java 新 手 都 非常 喜欢 使 用 System.out .println() 方法 来 打印 日 
志 ， 不 知道 你 是 不 是 也 喜欢 这 么 做 。 不 过 在 真正 的 项 目 开发 中 ， 是 极度 不 
建议 使 用 System.out .println() 方法 的 ! 如 果 你 在 公司 的 项 目 中 经 党 使 用 这 
个 方法 ， 束 很 有 可 能 要 挨 恕 了。 


为 什么 system.out .println() 方法 会 这 么 遭 大 家 唾弃 呢 ? 经 过 我 仔细 分 析 之 
后 ， 发 现 这 个 方法 除了 使 用 方便 一 点 之 外 ， 其 他 就 一 无 是 处 了 。 方 便 在 哪 
儿 呢 ? 在 Eclipse 中 你 只 需要 输入 syso， 然 后 按 下 代码 提示 键 ， 这 个 方法 就 会 
自动 出 来 了 ， 相 信 这 也 是 很 多 Java 狐 手 对 它 钟 情 的 原因 。 那 缺点 又 在 哪儿 了 
呢 ? 这 个 束 太 多 了 ， 比 如 日 志 打 印 不 可 控制 、 打 印 时 间 无 法 确定 、 不 能 添 
加 过 滤器 、 日 志 没 有 级 别 区 分 .….…. 


听 我 说 了 这 些 ， 你 可 能 已 经 不 太 想 用 System.out .println() 方法 了 ， 那么 
Log 就 把 上 面 所 说 的 缺点 全 部 都 改 好 了 吗 ? 虽然 谈 不 上 全 部 ， 但 我 觉得 Log 
已 经 做 得 相当 不 错 了 。 我 现在 就 来 带 你 看 看 Log 和 logcat 配 合 的 强大 之 处 。 


首先 刚才 提 到 的 快捷 输入 ， 在 Android Studio 当 中 也 是 有 的 ， 比 如 你 想 打 印 
一 条 debug 级 别 的 日 志 ， 那 么 只 需要 输入 logd， 然 后 按 下 Tab 键 ， 就 会 帮 你 自 
动 补 全 一 条 完整 的 打印 语句 。 和 输入 logi， 然 后 按 下 Tab 键 ， 会 目 动 补 全 一 条 
info 级 别 的 打印 日 志 。 输 入 logw， 按 下 Tab 键 ， 会 目 动 补 全 一 条 warn 级 别 的 
打印 日 志 ， 以 此 类 推 。 另 外 ， 由 于 Log 的 所 有 打印 方法 都 要 求 传 入 一 个 tag 参 
数 ， 每 次 写 一 过 显然 太 过 麻烦 。 这 里 还 有 一 个 小 技巧 ， 我 们 在 oncreate() 
方法 的 外 面 输入 logt， 然 后 按 下 Tab 键 ， 这 时 束 会 以 当前 的 类 名 作为 值 目 动 
生成 一 个 TAG 常 量 ， 如 下 所 示 : 


public class HelloworldActivity extends AppCompatActivity { 


private static final String TAG = "HelloworldActivity"; 


除了 快捷 输入 之 外 ，logcat 中 还 能 很 轻松 地 添加 过 滤器 ， 你 可 以 在 图 1.32 中 
看 到 我 们 目前 所 有 的 过 滤器 。 


Show only selected application 医 。 


Show only selected application 


Firebase 
No Filters 
Edit Filter Configuration 


图 1.32 logcat 中 的 过 滤器 


目前 只 有 3 个 过 滤 恬 ，Show only selected application 表 示 只 显示 当前 选中 程 
序 的 日 志 ， Firebase 是 谷歌 提供 的 一 个 分 析 工 具 ， 我 们 可 以 不 用 管 它 ，No 
Filters 相 当 于 没有 过 滤 怖 ， 会 把 所 有 的 日 志 都 显示 出 来 。 那 可 不 可 以 自 定 义 
过 滤器 呢 ? 当然 可 以 ， 我 们 现在 就 来 添加 一 个 过 滤器 试 试 。 


32 中 的 Edit Filter Configuration， 会 弹出 一 人 过 滤器 可 置 界 面 。 我 们 
过 滤器 起 名 叫 data， 并 且 让 它 对 名 为 data 的 tag 进 行 过 小， 如 图 1.33 所 示 。 


网 Create New Logcat Filter 


Filter Name: | data 


Specify one or several filtering parameters: 


Log Tag: \Qr data 3) Regex 


Log Message: i- Regex 


Package Name: @- Regex 


pID: | | 


Log Level: | Verbose 图 


[er | Cancel | 


图 1.33 过 滤器 配置 界面 


点 击 OK， 你 就 会 发 现 你 已 经 多 出 了 一 个 data 过 滤器 。 当 你 点 击 这 个 过 滤器 
的 时 候 ， 你 会 发 现 刚 才 在 oncreate() 方法 里 打印 的 日 志 没 了 ， 这 是 因为 data 
这 个 过 滤器 只 会 显示 tag 名 称 为 data 的 日 志 。 你 可 以 党 试 在 oncreate() 方法 
中 把 打印 日 志 的 语句 改 成 Log. d("data", "oncreate execute") ， 然 后 再 次 
运行 程序 ， 你 就 会 在 data 过 滤器 下 看 到 这 行 日 志 了 。 


不 知道 你 有 没有 体会 到 使 用 过 滤器 的 好 处 ， 可 能 现在 还 没有 吧 。 不 过 当 你 
的 程序 打印 出 成 百 上 千 行 日 志 的 时 候 ， 你 就 会 迫切 地 需要 过 滤器 了 。 


看 完了 过 滤器 ， 再 来 看 一 下 logcat 中 的 日 志 级 别 控制 吧 。logcat 中 主要 有 5 个 
级 别 ， 分 别 对 应 着 上 一 节 介 绍 的 5 个 方法 ， 如 图 1.34 所 示 。 


图 1.34 logcat 中 的 日 志 级 别 


当前 我 们 选中 的 级 别 是 verbose， 也 就 是 最 低 等 级 。 这 意味 着 不 管 我 们 使 用 
哪 一 个 方法 打印 日 志 ， 这 条 日 志 都 一 定 会 显示 出 来 。 而 如 果 我 们 将 级 别 选 

中 为 debug， 这 时 只 有 我 们 使 用 debug 及 以 上 级 别 方法 打印 的 日 志 才 会 显示 
出 来 ， 以 此 类 推 。 你 可 以 做 一 下 试验 ， 当 你 把 logcat 中 的 级 别 选 中 为 info、 
warn 或 者 error 时 ， 我 们 在 oncreate() 方法 中 打印 的 语句 是 不 会 显示 的 ， 
为 我 们 打印 日 志 时 使 用 的 是 Log.d() 方法 。 


日 志 级 别 控制 的 好 处 束 是 ， 你 可 以 很 ey 性 的 那些 日 志 。 相 信 

如 琳 让 你 从 上 千 行 日 志 中 查找 一 条 月 省 信息 ， 你 一 定 会 抓 狂 的 吧 。 而 现在 

ee 日 志 级 别 选 中 为 error， 那些 不 相生 的 天 引信 电 就 不 会 再 干扰 你 
视线 了 


最 后 我 们 再 来 看 一 下 关键 字 过 滤 。 如 果 使 用 过 滤器 加 日 志 级 别 控制 还 是 不 
能 锁定 到 你 想 查看 的 日 志 内 容 的 话 ， 那 么 还 可 以 通过 关键 字 进 行进 一 步 的 
过 小 ， 如 图 1.35 所 示 。 


(Qr onCreate ) Regex 


图 1.35 ”关键 字 输 入 框 


我 们 可 以 在 输入 框 里 输入 关键 字 的 内 容 ， 这 样 只 有 符合 关键 字条 件 的 日 志 
才 会 显示 出 来 ， 从 而 能 够 快速 定位 到 任何 你 想 查 看 的 日 志 。 男 外 还 有 一 点 
需要 注意 ， 关 键 字 过 滤 是 支持 正则 表达 式 的 ， 有 了 这 个 特性 ， 我 们 避 ® 可 以 
构建 出 更 加 丰富 的 过 滤 条 件 。 


天 于 Android 中 日 志 工 具 的 使 用 我 就 准备 讲 到 这 里 ，logcat 中 其 他 的 一 些 使 用 
技巧 承 要 靠 你 目 己 去 摸索 了 。 今 天 你 已 经 学 到 了 足够 多 的 东西 ， 我 们 来 总 
结 和 梳理 一 下 吧 。 


1.5 ”小结 与 点 评 


你 现在 一 定 会 觉得 很 充实 ， 其 至 有 点 沾沾自喜 。 确 实 应 该 如 此 ， 因 为 你 已 
经 成 为 一 名 真正 的 Android 开 发 者 了 。 通 过 本 章 的 学 习 ， 你 首先 对 Android 系 
统 有 了 更 加 充足 的 认识 ， 然 后 成 功 将 Android 开 发 环境 搭建 了 起 来 ， 接 着 创 
建 了 你 自己 的 第 一 个 Android 项 目 ， 并 对 Android 项 目的 目录 结构 和 执行 过 程 
有 了 一 定 的 认识 ， 在 本 章 的 最 后 还 学 习 了 Android 日 志 工 具 的 使 用 ， 这 难道 
还 不 够 充实 吗 ? 


不 过 你 也 别 太 过 于 满足 ， 相 信和 你 很 清楚 ，Android 开 发 者 和 出 色 的 Android 开 
发 者 还 是 有 很 大 的 区 别 的 ， 你 还 需要 付出 更 多 的 努力 才 行 。 即 使 你 目前 在 
Java 领 域 已 经 有 了 不 错 的 成 绩 ， 我 也 希望 在 Android 的 世界 你 可 以 放下 号 
段 ， 以 一 只 戎 级 小 菜鸟 的 身份 起 飞 ， 在 后 面 的 旅途 中 你 会 不 断 地 成 长 。 


现在 你 可 以 非常 安心 地 休 忆 一 段 时 间 ， 因 为 今天 你 已 经 做 得 非常 不 错 了 。 
储备 好 能 量 ， 准 备 进 入 到 下 一 章 的 旅程 当中 。 


和 分 ?7 
第 2 章 ” 先 从 看 得 到 的 入 手 一 一 探究 
通过 上 一 章 的 学 习 ， 你 已 经 成 功 创建 了 你 的 第 一 个 Android 项 目 。 不 过 仅仅 
满足 于 此 显然 是 不 够 的 ， 是 时 候 学 点 新 的 东西 了 。 作 为 你 的 导师 ， 我 有 义 
务 帮 你 制定 好 后 面 的 学 习 路 线 ， 那 么 今天 我 们 应 该 从 哪儿 入 手 呢 ? 现在 你 
可 以 想象 一 下 ， 假 如 你 已 经 写 出 了 一 个 非常 优秀 的 应 用 程序 ， 然 后 推荐 给 
你 的 第 一 个 用 户 ， 你 会 从 哪里 开始 介绍 呢 ? 毫 无 疑问 ， 当 然 是 从 界面 开始 
介绍 了 ! 因为 即使 你 的 程序 算法 再 高 效 ， 殿 构 再 出 色 ， 用 户 根本 不 会 在 乎 
这 些 ， 他 们 一 开始 只 会 对 看 得 到 的 东西 感 兴趣 ， 那 么 我 们 今天 的 主题 自然 
也 要 从 看 得 到 的 入 手 了 。 


vc 了 二 上 蝗 
2.1 ”活动 是 什么 
活动 (Activity) 是 最 容易 吸引 用 户 的 地 方 ， 它 是 一 种 可 以 包含 用 户 界 面 的 
组 件 ， 主 要 用 于 和 用 户 进行 交互 。 一 个 应 用 程序 中 可 以 包含 零 个 或 多 个 活 
动 ， 但 不 包含 任何 活动 的 应 用 程序 很 少见 ， 谁 也 不 想 让 自己 的 应 用 永远 无 
法 被 用 户 看 到 吧 ? 


其 实在 上 一 章 中 ， 你 已 经 和 活动 打 过 交道 了 ， 并 且 对 活动 也 有 了 初步 的 认 
识 。 不 过 上 一 章 我 们 的 重点 是 创建 你 的 第 一 个 Android 项 目 ， 对 活动 的 介绍 
并 不 多 ， 在 本 章 中 我 将 对 活动 进行 详细 的 介绍 。 


2.2 ”活动 的 基本 用 法 


到 现在 为 止 ， 你 还 没有 手动 创建 过 活动 呢 ， 因 为 上 一 章 中 的 
HelloWorldActivity 是 Android Studio 帮 我 们 目 动 创建 的 。 手 动 创建 活动 可 以 
加 深 我 们 的 理解 ， 因 此 现在 是 时 候 应 该 目 己 动手 了 。 


由 于 Android Studio 在 一 个 工作 区 间 内 只 允许 打开 一 个 项 目 ， 因 此 首先 你 需 
要 将 当前 的 项 目 关闭 ， 点 击 导 航 栏 File ~ Close Project。 然 后 再 新 建 一 个 
Android 项 目 ， 项 目 名 可 以 叫 作 ActivityTest， 包 名 我 们 就 使 用 默认 值 
com.example.activitytest。 新 建 项 目的 步 又 你 已 经 在 上 一 章 学 习 过 了 ， 不 过 
图 1.12 中 的 那 一 步 需要 稍 做 修改 ， 我 们 不 再 选择 Empty Activity 这 个 选项 ， 
而 是 选择 Add No Activity， 因 为 这 次 我 们 准备 手动 创建 活动 ， 如 图 2.1 所 


外 


Ax Add an Activity to Mobile 


Empty Activity 


Google AdMob Ads Activity Google Maps Activity Login Activity Master/Detail Flow 


Previous Next | | Cancel | | Enisn | 


图 2.1 选择 不 添加 活动 
点 击 Finish， 等 待 Gradle 构 建 完成 后 ， 项 目 就 创建 成 功 了 。 


2.2.1 手动 创建 活动 


项 目 创建 成 功 后 ， 仍 然 会 默认 使 用 Android 模 式 的 项 目 结构 ， 这 里 我 们 手动 
改 成 Project 模 式 ， 本 书 中 后 面 的 所 有 项 目 都 要 这 样 修改 ， 以 后 就 不 再 属 述 
了 。 目 前 ActivityTest 项 目 中 虽然 还 是 会 目 动 生成 很 多 文件 ， 但 是 
app/src/main/java/com.example.activitytest 目 录 应 该 是 空 的 了 ， 如 图 2.2 所 示 。 


[er ActivityTest Ci\Users\Administrator\AndroidSt 
bp DD .gradle 
DD .idea 
四 app 
四 build 
四 libs 
站 src 
四 androidTest 
四 main 
四 java 
加 com.example.activitytest 
[3 res 
号 AndroidManifestxml 
疡 test 
目 .gitignore 
[& app.iml 
( 公 build.gradle 
目 proguard-rules.pro 


图 2.2 初始 项 目 结构 


现在 右 击 com.example.activitytest 包 一 New 一 Activity Empty Activity， 会 弹 
出 一 个 创建 活动 的 对 话 框 ， 我 们 将 活动 命名 为 FirstActivity， 并 且 不 要 勾 选 
Generate Layout File 和 Launcher Activity 这 两 个 选项 ， 如 图 2.3 所 示 。 


(lolalile ld [Ae 


Android Studio 


Creates a new empty activity 


Activity Name: FirstActivity 


下 


口 ] Launcher Activity 


Backwards Compatibility (AppCompat) 


Package name: com.example.activitytest 


图 2.3 新 建 活动 对 话 框 


勺 选 Generate Layout File 表 示 会 目 动 为 FirstActivity 创 建 一 个 对 应 的 布局 文 
件 ， 义 选 Launcher Activity 表 示 会 目 动 将 FirstActivity 设 置 为 当前 项 目的 主 活 
动 ， 这 里 由 于 你 是 第 一 次 手动 创建 活动 ， 这 些 目 动 生成 的 东西 暂时 都 不 要 
义 选 ， 下 面 我 们 将 会 一 个 个 手动 来 完成 。 义 选 Backwards Compatibility 表 未 
会 为 项 目 局 用 回 下 兼容 的 模式 ， 这 个 选项 要 勾 上 。 点 击 Finish 完 成 创建 。 


你 需要 知道 ， 项 目 中 的 任何 活动 都 应 该 重 写 Activity 的 oncreate() 方法 ， 而 
目前 我 们 的 FirstActivity 中 已 经 重 写 了 这 个 方法 ， 这 是 由 Android Studio 目 动 
帮 有 我 们 完成 的 ， 代 码 如 下 所 示 : 


public class FirstActivity extends AppCompatActivity { 


Q@Override 
protected void onCreate(Bundle SavedInstanceState) { 
Super ,onCreate(SavedInstanceState ) ; 


| | 


可 以 看 到 ，oncreate( ) 方法 非常 借 单 ， 就 是 调用 了 父 类 的 oncreate() 方 
法 。 当 然 这 只 是 默认 的 实现 ， 后 面 我 们 还 需要 在 里 面 加 入 很 多 自己 的 逻 
辑 。 


2.2.2 ”创建 和 加 载 布局 


前 面 我 们 说 过 ，Android 程 序 的 设计 讲究 逻辑 和 视图 分 离 ， 最 好 每 一 个 活动 
都 能 对 应 一 个 布局 ， 布 局 就是 用 来 显示 界面 内 容 的 ， 因 此 我 们 现在 就 来 手 
动 创 建 一 个 布局 文件 。 


右 击 app/src/main/res 目 录 一 New 一 Directory， 会 弹出 一 个 新 建 目录 的 窗口 ， 
这 里 先 创建 一 个 名 为 layout 的 目录 。 然 后 对 着 layout 目 录 右 键 一 New 一 Layout 
resource file， 双 会 弹出 一 个 新 建 布局 资源 文件 的 窗口 ， 我 们 将 这 个 布局 文 
件 命名 为 first_layout， 根 元 素 就 默认 选择 为 LinearLayout， 如 图 2.4 所 示 。 


隔 
网 New Layout Resource File 


File name: | first_layout 


Root element: | LinearLayout 


本本 [= 


图 2.4 新 建 布局 资源 文件 
扩 击 OK 完成 布局 的 创建 ， 这 时 候 你 会 看 到 如 图 2.5 所 示 的 布局 编辑 髓 。 
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图 2.5 布局 编辑 器 


这 是 Android Studio 为 我 们 提供 的 可 视 化 布局 编辑 器 ， 你 可 以 在 屏 磊 的 中 央 
区 域 预 换 当前 的 布局 。 在 窗口 的 最 下 方 有 两 个 切换 卡 ， 左 边 是 Design， 砂 边 
臣 Text。Design 是 当前 的 可 视 化 布局 编辑 右 ， 在 这 里 你 不 仅 可 以 预 哆 当前 的 
布局 ， 还 可 以 通过 拖 放 的 方式 编辑 布局 。 而 Text 则 征 通 过 XML 文件 的 方式 
来 编辑 布局 的 ， 现 在 点 击 一 下 Text 切 换 卡 ， 可 以 看 到 如 下 代码 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


</LinearLayout> 


由 于 我 们 刚才 在 创建 布局 文件 时 选择 了 LinearLayout 作 为 根 元 素 ， 因 此 现在 
布局 文件 中 已 经 有 一 个 LinearLayout 元 素 了 。 屠 我 们 现在 对 这 个 布局 稍 做 编 
辑 ， 添 加 一 个 按钮 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/button_1" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Button 1" 
/> 


</LinearLayout> 


这 里 添加 了 一 个 Button 元 素 ， 并 在 Button 元 素 的 内 部 增加 了 几 个 属性 。 
android:id 是 给 当前 的 元 素 定 义 一 个 唯一 标识 件 ， 之 后 可 以 在 代码 中 对 这 
个 元 素 进 行 操 作 。 你 可 能 会 对 @+id/ button_1 这 种 语法 感到 陌生 ， 但 如 果 


把 加 号 去 掉 ， 变 成 @id/button_1 ， 这 样 你 束 会 觉得 有 些 熟悉 了 吧 ， 这 不 束 
是 在 XML 中 引用 资源 的 语法 吗 ? 只 不 过 是 把 string 玲 换 成 了 id。 是 的 ， 如 
果 你 需要 在 XML 中 引用 一 个 id ， 就 使 用 @id/id_name 这 种 语法 ， 而 如 果 你 
需要 在 XML 中 定义 一 个 id ， 则 要 使 用 @+id/id_name 这 种 语法 。 随 后 
android:1layout_width 指定 了 当前 元 素 的 宽度 ， 这 里 使 用 match_parent 表示 
让 当前 元 素 和 父 元 素 一 样 宽 ° android:layout_height 指定 了 当前 元 素 的 高 
度 ， 这 里 使 用 wrap_content 表示 当前 元 素 的 高 度 只 要 能 刚好 包含 里 面 的 内 
容 束 行 。android:text 指定 了 元 素 中 显示 的 文字 内 容 。 如 果 你 还 不 能 完全 
看 明白 ， 没 有 关系 ， 关 于 编写 布局 的 详细 内 容 我 会 在 下 一 章 中 重点 讲解 ， 
本 章 只 是 先 简单 涉及 一 些 。 现 在 按钮 已 经 添加 完了 ， 你 可 以 通过 右 侧 工具 
栏 的 Preview 来 预 氏 一 下 当前 布局 ， 如 图 2.6 所 示 。 
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图 2.6 预览 当前 布局 


可 以 看 到 ， 按 钮 已 经 成 功 显 示 出 来 了 ， 这 样 一 个 简单 的 布局 束 编 写 完 成 
了 。 那 么 接 下 来 我 们 要 做 的 ， 融 是 在 活动 中 加 载 这 个 布局 。 


重新 回 到 FirstActivity， 在 oncreate() 方法 中 加 入 如 下 代码 : 


public class FirstActivity extends AppCompatActivity { 


Q@Override 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedIinstanceSstate); 
setcontentView(R.1layout.first_layout); 


} 


可 以 看 到 ， 这 里 调用 了 setcontentview() 方法 来 给 当前 的 活动 加 载 一 个 布 

局 ， 而 在 setcontentview() 方法 中 ， 我 们 一 般 都 会 传 入 一 个 布局 文件 的 id 

。 在 第 1 章 介绍 项 目 资源 的 时 候 我 兽 提 到 过 ， 项 目 中 添加 的 任何 资源 都 会 在 
R 文 件 中 生成 一 个 相应 的 资源 1 ， 因此 我 们 刚才 创建 的 first_layout .xml 布 
局 的 id 人 在 代码 中 去 引用 布局 文件 的 方法 
你 也 已 经 学 过 了 ， 只 需要 调用 R.1layout .first_layout 就 可 以 得 到 


人 . Xml 布局 的 id 然后 将 这 个 值 传 入 setcontentView() 方法 即 
可 o 


2.2.3 在 AndroidManifest 文 件 中 注册 


别 筷 了 在 上 一 章 我 们 学 过 ， 所 有 的 活动 都 要 在 AndroidManifest,xml 中 进行 注 
册 才 能 生效 ， 而 实际 上 FirstActivity 已 经 在 AndroidManifest.xml 中 注册 过 了 ， 
我 们 打开 app/srcmain/AndroidManifest,xml 文 件 瞧 一 瞧 ， 人 代码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.activitytest"> 
<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity android:name=" .FirstActivity"></activity> 
</application> 
</manifest> 


可 以 看 到 ， 活 动 的 注册 声明 要 放 在 <application> 标签 内 ， 这 里 是 通过 
<activity> 标签 来 对 活动 进行 注册 的 。 那 么 又 是 谁 帮 有 我 们 目 动 完成 了 对 
FirstActivity 的 注册 呢 ? 当然 是 Android Studio 了 ， 之 前 在 使 用 Eclipse 创建 活 
动 或 其 他 系统 组 件 时 ， 很 多 人 都 会 扎 记 要 去 Android Manifest.xml 中 注册 一 
> 从 而 导致 程序 运行 月 浇 ， 很 显然 Android Studio 在 这 方面 做 得 更 加 人 性 
七 o 


在 <activity> 标签 中 我 们 使 用 了 android:name 来 指定 具体 注册 哪 一 个 活 
动 ， 那 么 这 里 填 入 的 .FirstActivity 是 什么 意思 呢 ? 其 实 这 不 过 就 是 
com.example.activitytest.FirstActivity 的 缩写 而 已 。 由 于 在 最 外 层 的 


<manifest> 标签 中 已 经 通过 package 属性 指定 了 程序 的 包 名 是 
com.example.activitytest,, 因此 在 注册 活动 时 这 一 部 分 残 可 以 省 略 了 ,有 直 
接 使 用 .FirstActivity 就 足够 了 。 


不 过 ， 仅 仅 是 这 样 注 册 了 活动 ， 我 们 的 程序 仍然 是 不 能 运行 的 ， 因 为 还 没 
有 为 程序 配置 主 活动 ， 也 就 是 说 ， 当 程序 运行 起 来 的 时 候 ， 不 知道 要 首先 
局 动 哪个 活动 。 配 置 主 活动 的 方法 其 实在 第 1 章 中 已 经 介绍 过 了 ， 束 是 在 
<activity> 标签 的 内 部 加 入 <intent-filter> 标签 ， 并 在 这 个 标签 里 添加 
<action android:name="android,.intent.action.MAIN"/> 和 <category 
android: name="android,.intent.category.LAUNCHER" /> 这 两 句 声 明 即 可 。 


除 此 之 外 ， 我 们 还 可 以 使 用 android:1abel 指定 活动 中 标题 栏 的 内 容 ， 标 题 

栏 是 显示 在 活动 最 顶部 的 ， 符 会 儿 运 行 的 时 候 你 就 会 看 到 。 需 要 注意 的 

是 ， 给 主 活动 指定 的 label 不 仪 会 成 为 标题 栏 中 的 内 容 ， 还 会 成 为 启动 如 
(Launcher) 中 应 用 程序 显示 的 名 称 。 


修改 后 的 AndroidManifest.xml 文 件 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.activitytest"> 
<application 
i 


<activity android:name=" .FirstActivity" 
android:label="This is FirstActivity"> 
<intent-filter> 
<action android:name="android,.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


这 样 的 话 ，FirstActivity 束 成 为 我 们 这 个 程序 的 主 活动 了 ， 即 点击 桌面 应 用 
程序 图 标 时 首先 打开 的 就 是 这 个 活动 。 男 外 需要 注意 ， 如 果 你 的 应 用 程序 
中 没有 声明 任何 一 个 活动 作为 主 活动 ， 这 个 程序 仍然 是 可 以 正常 安装 的 ， 
只 是 你 无 法 在 启动 器 中 看 到 或 者 打开 这 个 程序 。 这 种 程序 一 般 痢 是 作为 第 
三 方 服务 供 其 他 应 用 在 内 部 进行 调用 的 ， 如 文 付 至 快捷 文 付 服务 。 


好 了 ， 现 在 一 切 都 已 准备 瑞 绪 ， 让 我 们 来 运行 一 下 程序 吧 ， 结 采 如 图 2.7 所 
太 ° 
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图 2.7 首次 运行 结果 


在 界面 的 最 顶部 是 一 个 标题 栏 ， 里 面 显 示 着 我 们 刚才 在 注册 活动 时 指定 的 
内 容 。 标 题 栏 的 下 面 惑 是 在 布局 文件 first_layout.xml 中 编写 的 界面 ， 可 以 看 
到 我 们 刚刚 定义 的 按钮 。 现 在 你 已 经 成 功 掌 握 了 手动 创建 活动 的 万 法 ， 下 
面 让 我 们 继续 看 一 看 你 在 活动 中 还 能 做 哪些 事情 吧 。 


2.2.4 在 活动 中 使 用 Toast 


Toast 是 Android 系 统 提 供 的 一 种 非常 好 的 提醒 方式 ， 在 程序 中 可 以 使 用 它 将 
一 些 短小 的 信息 通知 给 用 户 ， 这 些 信 息 会 在 一 段 时 间 后 上 自动 消失 ， 并 且 不 
会 占用 任何 屏幕 空间 ， 我 们 现在 就 尝试 一 下 如 何在 活动 中 使 用 Toast 。 


首先 需 要 定义 一 个 弹出 Toast 的 触发 点 ， 正 好 界面 上 有 个 按钮 ， 那 我 们 就 让 
点 击 这 个 按钮 的 时 候 弹 出 一 个 Toast 吧 。 在 oncreate() 方法 中 添加 如 下 代 
码 : 


protected void onCreate(Bundle SavedInstanceState) { 
super .onCreate(savedInstanceState); 
setCcontentView(R.Jlayout.first_ layout); 
Button button1 = (Button) findViewById(R.id.button_1); 
buttoni1.setOonclickListener(new View.OnClickListener() { 
Q@Override 
public void oncClick(View v) { 
Toast.makeText(FirstActivity.this, "You clicked Button 1", 
Toast .LENGTH_SHORT) .show( )， 
} 
}); 


在 活动 中 ， 可 以 通过 findviewById() 方法 获取 到 在 布局 文件 中 定义 的 元 
素 ， 这 里 我 们 传 入 R.id.button_1 ， 来 得 到 按钮 的 实例 ， 这 个 值 是 刚才 在 
first_layout.xzml 中 通过 android:id 属性 指定 的 。findviewById() 方法 返回 的 

是 一 个 view 对 象 ， 我 们 需要 向 下 转型 将 它 转 成 Button 对 象 。 得 到 按钮 的 实 
例 之 后 ， 我 们 通过 调用 setonclickListener() 方法 为 按钮 注册 一 个 监听 器 
点 击 按钮 时 就 会 执行 监听 器 中 的 onclick() 方法 。 因 此 ， 弹 出 Toast 的 功能 
然 是 要 在 onclick() 方法 中 编写 了 。 


Toast 的 用 法 非常 简单， 通过 裔 仿 万 法 makeText() 创建 出 一 Toast 对 象 ， 然 
后 调用 show() 将 Toast 显 示 出 来 束 可 以 了 。 这 里 需要 注意 的 是 ，makeText() 
方法 需要 传 入 3 个 参数 。 第 一 个 参数 是 context ， 也 就 是 Toast 要 求 的 上 下 
文 ， 由 于 活动 本 身 就 是 一 个 context 对 象 ， 因 此 这 里 直接 传 入 
FirstActivity.this 即 可 。 第 二 个 参数 是 Toast 显 示 的 文本 内 容 ， 第 三 个 参 
数 是 Toast 显 示 的 时 长 ， 有 两 个 内 置 常 量 可 以 选择 Toast .LENGTH_SHORT 和 
Toast .LENGTH_LONG ° 


现在 重新 运行 程序 ， 并 点击 一 下 按钮 ， 效 果 如 图 2.8 所 示 。 


This is FirstActivity 
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图 2.8 Toast 运 行 效 果 


2.2.5 ”在 活动 中 使 用 Menu 


手机 毕竟 和 电脑 不 同 ， 它 的 屏幕 空间 非常 有 限 ， 因 此 充分 地 利用 屏幕 空间 
在 手机 界面 设计 中 就 显得 非常 重要 了 “。 如 果 你 的 活动 中 有 大 量 的 菜单 需要 
显示 ， 这 个 时 候 界 面 设计 束 会 比较 尴 罚 ， 因 为 仅 这 些 菜 单 束 可 能 占用 屏 闫 
将 近 三 分 之 一 的 空间 ， 这 该 怎么 办 呢 ? 不 用 担心 ，Android 给 我 们 提供 了 一 
种 方式 ， 可 以 让 羔 单 都 能 得 到 展示 的 同时 ， 还 能 不 占用 任何 屏幕 空间 。 


首先 在 res 目 录 下 新 建 一 个 menu 文 件 夹 ， 右 击 res 目 录 一 New 一 Directory， 输 
入 文件 夹 名 menu， 点 击 OK。 拉 着 在 这 个 文件 夹 下 再 新 建 一 个 名 叫 main 的 菜 
单 文 件 ， 右 击 menu 文 件 夹 -New 一 Menu resource file， 如 图 2.9 所 示 。 
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图 2.9 ”新建 Menu 资 源 文件 
文件 名 输入 main， 点 击 OK 完成 创建 。 然 后 在 main.xml 中 添加 如 下 代码 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<item 


android:id="@+id/add_item" 
android:title="Add"/> 
<item 
android:id="@+id/remove_item" 
android:title="Remove"/> 
</menu> 


这 里 我 们 创建 了 两 个 菜单 项 ， 其 中 <item> 标签 就 是 用 来 创建 具体 的 某 一 个 
荣 单 项 ， 然 后 通过 android:id 给 这 个 菜单 项 指定 一 个 唯一 的 标识 人 特 ， 通 过 
android:title 给 这 个 菜单 项 指定 一 个 名 称 。 


接着 重新 回 到 FirstActivity 中 来 重 写 oncreateoptionsMenu( ) 方法 ， 重 写 方法 
可 以 使 用 Ctrl + O 快 捷 键 (Mac 系统 是 control + O) ， 如 图 2.10 所 示 。 
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图 2.10 重 写 oncreateoptionsMenu() 方法 
然后 在 oncreateoptionsMenu( ) 方法 中 编写 如 下 代码 : 


public boolean onCreateOptionsMenu(Menu menu) { 
getMenuInflater().inflate(R.menu.main, menu); 
return true; 


通过 getMenuInflater() 方法 能 够 得 到 MenuInflater 对 和 象 ， 再 调用 它 的 
inflate() 方法 束 可 以 给 当前 活动 创建 菜单 了 。inflate() 方法 接收 两 个 参 
数 ， 第 一 个 参数 用 于 指定 我 们 通过 哪 一 个 资源 文件 来 创建 菜单 ， 这 里 当然 
传 入 R.menu.main。 第 二 个 参数 用 于 指定 我 们 的 茉 单 项 将 添加 a 到 哪 一 个 Menu 
对 象 当 中 ， 这 里 直接 使 用 oncreateoptionsMenu() 方法 中 传 入 的 menu 参数 。 
然后 给 这 个 方法 返回 true ， 表 示人 允许 创建 的 荣 单 显示 出 来 ， 如 有 果 返 回 了 
false ， 创 建 的 菜单 将 无 法 显示 。 


当然 ， 仅 仅 让 菜单 显示 出 来 是 不 够 的 ， 我 们 定义 菜单 不 仅 是 为 了 看 的 ， 关 


键 是 要 沫 单 真 正 可 用 才 行 ， 因 此 还 有 要 再 定义 集 单 啊 应 事件 。 在 FirstActivity 
中 重 写 onoptionsItemSelected() 方法 : 


public boolean onOptionsItemSelected(MenuItem item) { 
switch (item.getItemId()) { 


case R.id.add_item: 
Toast.makeText(this, "You clicked Add", Toast.LENGTH_SHORT).show(); 
break; 

case R.id.remove_item: 
Toast.makeText(this, "You clicked Remove", Toast.LENGTH_SHORT).show(); 
break; 

default: 


return true,; 


在 onoptionsItemSelected() 方法 中 ， 通过 调用 item.getItemId() 来 判断 我 
们 点 击 的 是 哪 一 个 菜单 项 ， 然 后 给 每 个 菜单 项 加 入 上 自己 的 逻辑 处 理 ， 这 里 
我 们 就 活 学 活用 ， 弹 出 一 个 刚刚 学 会 的 Toast 。 


重新 运行 程序 ， 你 会 发 现在 标题 栏 的 右 侧 多 了 一 个 三 点 的 符号 ， 这 个 就 是 
亲 单 按钮 了 ， 如 图 2.11 所 示 。 


This is FirstActivity 


图 2.11 带 菜 单 按钮 的 活动 


可 以 看 到 ， 菜 单 里 的 菜单 项 默认 是 不 会 显示 出 来 的 ， 只 有 点 击 一 下 菜单 按 
钮 才 会 弹出 里 面具 体 的 内 容 ， 因 此 它 不 会 占用 任何 活动 的 空间 ， 如 图 2.12 所 
ZX ” 


图 2.12 弹出 菜单 项 的 界面 


然后 如 果 你 点 击 了 Add 深 单项 就 会 弹出 You dicked Add 提 示 (如 图 2.13 所 
示 ) ， 如 果 点 击 了 Remove 荣 单项 就 会 弹出 You clicked Remove 提 示 。 
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图 2.13 点击 了 Add 荣 单项 
2.2.6 ”销毁 一 个 活动 


通过 上 一 节 的 学 习 ， 你 已 经 掌握 了 手动 创建 活动 的 方法 ， 并 学 会 了 如 何在 
活动 中 创建 Toast 和 他 陵 菜单 。 或 许 你 现在 心中 会 有 个 疑惑 ， 如 何 销 纳 一 个 
活动 呢 ? 


其 实 答案 非常 简单 ， 只 要 按 一 下 Back 键 就 可 以 销毁 当前 的 活动 了 。 不 过 如 
果 你 不 想 通过 按键 的 方式 ， 而 是 希望 在 程序 中 通过 代码 来 销毁 活动 ， 当 然 
也 可 以 ，Activity 类 提供 了 一 个 finish() 方法 ， 我 们 在 活动 中 调用 一 下 这 个 
方法 就 可 以 销毁 当前 活动 了 。 


修改 按钮 监听 右 中 的 代码 ， 如 下 所 示 : 


buttoni1.setOonclickListener(new View.OnClickListener() { 
Q@Override 
public void onClick(View v) { 
finish(); 


重新 运行 程序 ， 这 时 点 击 一 下 按钮 ， 当 前 的 活动 就 被 成 功 销毁 了 ， 效 果 和 
按 下 Back 键 是 一 样 的 。 


2.3 ”使 用 Intent 在 活动 之 间 穿 权 


只 有 一 个 活动 的 应 用 也 太 简单 了 吧 ? 没 错 ， 你 的 追求 应 该 更 高 一 点 。 不 管 
你 想 创建 多 少 个 活动 ， 方 法 都 和 上 一 节 中 介绍 的 是 一 样 的 。 唯 一 的 问题 在 
于 ， 你 在 启动 器 中 点 击 应 用 的 图 标 只 会 进入 到 该 应 用 的 主 活动 ， 那 么 怎样 
才能 由 主 活动 跳 转 到 其 他 活动 呢 ? 我 们 现在 就 来 一 起 看 一 看 。 


2.3.1 ”使 用 显 式 Intent 


你 应 该 已 经 对 创建 活动 的 流程 比较 熟悉 了 ， 那 我 们 现在 快速 地 在 
ActivityTest 项 目 中 再 创建 一 个 活动 。 


CC 


仍然 还 是 右 击 com.example.activitytest 包 ~ New 一 Activity > Empty Activity， 
会 弹出 一 个 创建 活动 的 对 话 框 ， 我 们 这 次 将 活动 命名 为 SecondActivity， 并 
勺 选 Generate Layout File， 给 布局 文件 起 名 为 second_layout， 但 不 要 勾 选 
Launcher Activity 选 项 ， 如 图 2.14 所 示 。 


olilo lV- dL 


Android Studio 


Creates a new empty activity 


Activity Name: | SecondActivity 


Generate Layout File 


second_layout 


DD Launcher Activity 
Backwards Compatibility (AppCompat) 


Package name: com.example.activitytest 


| | Cancel | Finish 


图 2.14 创建 SecondActivity 


点 击 Finish 完 成 创建 ，Android Studio 会 为 我 们 目 动 生成 SecondActivityjava 和 
second_layout.xml 这 两 个 文件 。 不 过 目 动 生成 的 布局 代码 目前 对 你 来 说 可 能 
有 些 复杂 ， 这 里 我 们 仍然 还 是 使 用 最 熟悉 的 LinearLayout， 编 辑 
second_layout.xml， 将 里 面 的 代码 奉 换 成 如 下 内 容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/button_2" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Button 2" 
/> 


</LinearLayout> 


我 们 还 是 定义 了 一 个 按钮 ， 按 钮 上 显示 Button 2 。 


然后 SecondActivity 中 的 代码 已 经 自动 生成 了 一 部 分 ， 我 们 保持 默认 不 变 丈 
好 ， 如 下 所 示 : 


public class SecondActivity extends AppCompatActivity { 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.second_ layout); 


} 


另外 不 要 访 记 ， 任 何 一 个 活动 都 是 需要 在 AndroidManifest.xml 中 注册 的 ， 不 
过 笠 运 的 是 ，Android Studio 已 经 帮 我 们 自动 完成 了 ， 你 可 以 打开 
AndroidManifest.xzml 有 瞧 一 瞧 : 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity 
android:name=" .FirstActivity" 
android:label="This is FirstActivity"> 
<intent-filter> 


<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity android:name=".SecondActivity"></activity> 
</application> 


由 于 SecondActivity 不 是 主 活动 ， 因 此 不 需要 配置 <intent-filter> 标签 里 的 
内 容 ， 注 册 活 动 的 代码 也 1 向 单 了 许多 。 现在 第 二 个 活动 已 经 创建 完成 ， 和 列 
下 的 问题 就 是 如 何 去 启 动 这 第 二 个 活动 了 ， 这 里 我 们 需要 引入 一 个 新 的 概 


念 : Intent。 


Itent 是 Android 程 序 中 各 组 件 之 间 进 行 交 互 的 一 种 重要 方式 ， 它 不 仅 可 以 指 
明 当 前 组 件 想 要 执行 的 动作 ， 还 可 以 在 不 同 组 件 之 间 传 递 数 据 。Intent 一 般 
可 被 用 于 局 动 活 动 、 局 动 服务 以 及 发 送 广 播 等 场景 ， 由 于 服务 、 广 播 等 概 

念 你 暂时 还 未 涉及 ， 那 么 本 章 我 们 的 目光 无 疑 就 锁定 在 了 启动 活动 上 面 。 


Intent 大 致 可 以 分 为 两 种 : 显 式 Intent 和 隐 式 Intent ， 我 们 先 来 看 一 下 显 式 
Intent 如 何 使 用 。 


Intent 有 多 个 构造 函数 的 重 载 ， 其 中 一 个 是 Intent (Context packageContext, 
class<?> cls) 。 这 个 构造 函数 接收 两 个 参数 ， 第 一 个 参数 context 要 求 提 
供 一 个 局 动 活动 的 上 下 文 ， 第 二 个 参数 class 则 是 指定 想 要 局 动 的 目标 活 
动 ， 通 过 这 个 构造 函数 就 可 以 构建 出 Intent 的 “意图 ”。 然 后 我 们 应 该 怎么 
使 用 这 个 Intent 呢 ? Activity 类 中 提供 了 一 广 StartActivity() 2 sD 
法 是 专门 用 于 启动 活动 的 ， 它 接收 一 个 Intent 参数 ， 这 里 我 们 将 构建 好 的 
Intent 传 入 startActivity() 方法 就 可 以 启动 目标 活动 了 。 


修改 FirstActivity 中 按钮 的 点 击 事件 ， 代 码 如 下 所 示 : 


button1.SsetonCclickListener(new View.OnClickListener() { 
QOverride 
public void onClick(View v) { 
Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
startActivity(intent); 


我 们 首先 构建 出 了 一 个 Intent， 传 入 FirstActivity.this 作为 上 下 文 ， 传 入 
secondActivity.class 作为 目标 活动 ， 这 样 我 们 的 “意图 ”就 非常 明显 了 ， 即 
在 FirstActivity 这 个 活动 的 基础 上 打开 SecondActivity 这 个 活动 。 然 后 通过 
startActivity() 方法 来 执行 这 个 Intent。 


重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 ， 结 采 如 图 2.15 所 示 。 


ActivityTest 


BUTTON 2 


图 2.15 ”SecondActivity 界 面 


可 以 看 人 到， 我 们 已 经 成 功 启动 SecondActivity 这 个 活动 了 。 如 果 你 想 要 回 到 
上 一 个 活动 怎么 办 呢 ? 很 简单 ， 按 下 Back 键 承 可 以 销毁 当前 活动 ， 从 而 回 
到 上 一 个 活动 了 。 


使 用 这 种 方式 来 启动 活动 ，Intent 的 “意图 ”非常 明显 ， 因 此 我 们 称 之 为 显 式 


Intent ° 


2.3.2 ”使 用 隐 式 Intent 


相 比 于 显 式 Intent， 隐 式 Intent 则 含蓄 了 许多 ， 它 并 不 明确 指出 我 们 想 要 启动 
哪 一 个 活动 ， 而 是 指定 了 一 系列 更 为 抽象 的 action 和 category 等 信息 ， 然 
后 交 由 系统 去 分 析 这 个 Intent， 并 帮 有 我 们 找 出 合适 的 活动 去 启动 。 


什么 叫 作 合适 的 活动 呢 ? 简单 来 说 束 是 可 以 响应 我 们 这 个 隐 式 Intent 的 活 
动 ， 那 么 目前 SecondActivity 可 以 啊 应 什么 样 的 隐 式 Intent 呢 ? 额 ， 现 在 好 像 


还 什么 都 啊 应 不 了 ， 不 过 很 快 束 会 有 了 。 


通过 在 <activity> 标签 下 配置 <intent-filter> 的 内 容 ， 可 以 指定 当前 活动 
能 够 啊 应 的 action 和 category ， 打 开 AndroidManifest.xml， 添 加 如 下 代 
码 : 


<activity android:name=".SecondActivity" > 
<intent-filter> 
<action android:name="com.example.activitytest.ACTION_START" /> 
<category android:name="android.intent.category.DEFAULT" /> 
</intent-filter> 


</activity> 


在 <action> 标签 中 我 们 指明 了 当前 活动 可 以 啊 应 
com.example.activitytest.ACTION_START 这 个 action ， 而 <category> 标签 
则 包含 了 一 些 附 加 信息 ， 更 精确 地 指明 了 当前 的 活动 能 够 啊 应 的 Intent 中 还 
可 能 带 有 的 category 。 只 有 <action> 和 <category> 中 的 内 容 同 时 能 够 匹配 
上 Intent 中 指定 的 action 和 category 时 ， 这 个 活动 才能 响应 该 Intent 9 


修改 FirstActivity 中 按钮 的 点 击 事件 ， 代 码 如 下 所 示 : 


button1.SsetonCclickListener(new View.OnClickListener() { 
QOverride 
public void onClick(View v) { 
Intent intent = new Intent("com.example.activitytest.ACTION_ START"); 
startActivity(intent); 


可 以 看 到 ， 我 们 使 用 了 Intent 的 另 一 个 构造 函数 ， 直 接 将 action 的 字符 串 传 
了 进去 ， 表 明 我 们 想 要 启动 能 够 响应 

com.example .activitytest .ACTION_START 这 个 action 的 活动 。 那 前 面 不 是 

说 要 <action> 和 <category> 同时 匹配 上 才能 啊 应 的 吗 ? 怎么 没 看 到 哪里 有 

指定 category 呢 ? 这 是 因为 android,.intent.category.DEFAULT 是 一 种 默认 

的 category ， 在 调用 startActivity() 方法 的 时 候 会 自动 将 这 个 category 添 
加 到 Intent 中 。 


重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 ， 你 同样 成 功 局 动 
SecondActivity 了。 不 同 的 十， 这 次 你 是 使 用 了 隐 式 Intent 的 方式 来 局 动 的 ， 


说 明 我 们 在 <activity> 标签 下 配置 的 action 和 category 的 内 容 已 经 生效 
了! 


每 个 Intent 中 内 能 指定 一 个 action ， 但 却 能 指定 多 个 category。 目 前 我 们 的 
Intent 中 只 有 一 个 默认 的 category ， 那 么 现在 再 来 增加 一 个 吧 。 


修改 FirstActivity 中 按钮 的 点 击 事件 ， 代 码 如 下 所 示 : 


Ne 


button1.SsetonCclickListener(new View.OnClickListener() { 
QOverride 
public void onClick(View v) { 


Intent intent = new Intent("com.example.activitytest.ACTION_ START"); 
intent.addCategory("com.example.activitytest.MY_CATEGORY"); 
startActivity(intent); 


可 以 调用 Intent 中 的 addcategory() 方法 来 添加 一 个 category ， 这 里 我 们 指 
定 了 一 个 目 定 义 的 category 值 为 com.example.activitytest.MY_CATEGORY 


Le] 


现在 重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 ， 你 会 发 现 ， 程 序 
裔 江 了 ! 这 是 你 第 一 次 遇 到 程序 拓 泪 ， 可 能 会 有 些 束手无策 。 别 紧张， 其 
实 大 多 数 的 朋 演 问题 都 是 很 好 解决 的 ， 只 要 你 普 于 分 析 。 在 logcat 界 面 查看 
普 误 日 志 ， 你 会 看 到 如 图 2.16 所 示 的 错误 信息 。 


Process: com. example.activitytest, PID: 24027 
android. content. ActivityNotFomdException: No Activity found to handle Intent | 
act=com. example. activitytest. ACTION_START cat=[com. example. activitytest. MY CATEGORY] } 


图 2.16 错误 信息 


错误 信息 中 提醒 我 们 ， 没 有 任何 一 个 活动 可 以 响应 我 们 的 Intent， 为 什么 
呢 ? 这 是 因为 我 们 刚刚 在 Intent 中 新 增 了 一 个 category ， 而 SecondActivity 的 
<intent-filter> 标签 中 并 没有 声明 可 以 响应 这 个 category ， 所 以 驶 出 现 了 
没有 任何 活动 可 以 啊 应 该 Intent 的 情况 。 现 在 我 们 在 <intent-filter> 中 再 添 
加 一 个 category 的 声明 ， 如 下 所 示 : 


<activity android:name=".SecondActivity" > 
<intent-filter> 
<action android:name="com.example.activitytest.ACTION_START" /> 
<category android:name="android.intent.category.DEFAULT" /> 
<category android:name="com.example.activitytest.MY_CATEGORY"/> 
</intent-filter> 


</activity> 


再 次 重新 运行 程序 ， 你 就 会 发 现 一 切 都 正常 了 。 


2.3.3 ”更 多 隐 式 Intent 的 用 法 


上 一 市 中 ， 你 掌握 了 通过 隐 式 Intent 来 局 动 活 动 的 方法 ， 但 实际 上 隐 式 Intent 
还 有 更 多 的 内 容 需 要 你 去 了 解 ， 本 节 我 们 就 来 展开 介绍 一 下 。 


使 用 隐 式 Intent， 我 们 不 仅 可 以 启动 自己 程序 内 的 活动 ， 还 可 以 启动 其 他 程 
序 的 活动 ， 这 使 得 Android 多 个 应 用 程序 之 间 的 功能 共享 成 为 了 可 能 。 比 如 
说 你 的 应 用 程序 中 需要 展示 一 个 网 页 ， 这 时 你 没有 必要 自己 去 实现 一 个 浏 
提 绒 【事实 上 也 不 太 可 能 )， 而 是 只 需要 调用 系统 的 浏览 来 打开 这 个 风 
页 就 行 了 。 


修改 FirstActivity 中 按钮 点 击 事件 的 代码 ， 如 下 所 示 : 


button1.SsetonCclickListener(new View.OnClickListener() { 
QOverride 
public void onClick(View v) { 


Intent intent = new Intent(Intent.ACTION_VIEW); 
intent.setData(Uri.parse("http://www.baidu.com")); 
startActivity(intent); 


这 里 我 们 首先 指定 了 Intent 的 action 是 Intent .ACTION_VIEW ， 这 是 一 个 
Android 系 统 内 置 的 动作 ， 其 常量 值 为 android.intent.action.VIEW。 然 后 
通过 uri.parse() 方法 ， 将 一 个 网 址 字符 串 解 析 成 一 个 uri 对 象 ， 再 调用 
Intent 的 setData( ) 方法 将 这 个 uri 对 象 传递 进去 。 


重 狐 运行 程序 ， 在 FirstActivity 界 面 点 击 按钮 就 可 以 看 到 打开 了 系统 浏览 
家， 如 图 2.17 所 示 。 


www.baidu.com 


图 2.17 系统 浏览 器 界面 

在 上 述 代 码 中 ， 可 能 你 会 对 setpata( ) 部 分 感觉 到 卫生 ， 这 古 我 们 前 面 没 有 
讲 到 的 。 这 个 方法 其 实 并 不 复 厅 ， 它 接收 一 个 uri 对 象 ， 主 要 用 于 指定 当前 
Itent 正 在 操作 的 数据 ， 而 这 些 数据 通常 都 是 以 字符 串 的 形式 传 入 到 
Uri.parse() 方法 中 解析 产生 的 。 


与 此 对 应 ， 我 们 还 可 以 在 <intent-filter> 标签 中 再 配置 一 个 <data> 标签 ， 
用 于 更 精确 地 指定 当前 活动 能 够 响应 什么 类 型 的 数据 。<data> 标签 中 主要 
可 以 配置 以 下 内 容 。 


android:scheme 。 用 于 指定 数据 的 协议 部 分 ， 如 上 例 中 的 http 部 分 。 
android:host 。 用 于 指定 数据 的 主机 名 部 分 ， 如 上 例 中 的 


www.baidu.com 部 分 。 


android:port ° 用 于 指定 数据 的 端口 部 分 ， 一 般 紧 随 在 主机 名 之 后 


。android:path 。 用 于 指定 主机 名 和 端口 之 后 的 部 分 ， 如 一 段 网 址 中 跟 
在 域名 之 后 的 内 容 。 


e android:mimeType ° 用 于 指定 可 以 处 理 的 数据 类 型 ， 允许 使 用 通配符 
的 方式 进行 指定 。 


只 有 <data> 标签 中 指定 的 内 容 和 Intent 中 携带 的 Data 完 全 一 致 时 ， 当 前 活动 
才能 够 响应 该 Intent。 不 过 一 般 在 <data> 标签 中 都 不 会 指定 过 多 的 内 容 ， 如 
上 面 浏 览 器 示例 中 ， 其 实 只 需要 指定 android:scheme 为 htp， 就 可 以 响应 所 
有 的 http 协 议 的 Intent 了 。 


为 了 让 你 能 够 更 加 直观 地 理解 ， 我 们 来 自己 建立 一 个 活动 ， 让 它 也 能 响应 
打开 网 页 的 Intent 。 


右 击 com.example.activitytest 包 ~ New Activity~ Empty Activity， 新 建 
ThirdActivity， 并 人 勾 选 Generate Layout File， 给 布局 文件 起 名 为 third_layonut， 
点 击 Finish 完 成 创建 。 然 后 编辑 third_layout.xzml， 将 里 面 的 代码 替换 成 如 下 
内 容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/button_3" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Button 3" 
/> 


</LinearLayout> 


ThirdActivity 中 的 代码 保持 不 变 就 可 以 了 ， 最 后 在 AndroidManifest.xml 中 修 
改 ThirdActivity 的 注册 信息 .: 


<activity android:name=".ThirdActivity"> 
<intent-filter> 
<action android:name="android.intent.action.VIEW" /> 
<category android:name="android.intent.category.DEFAULT" /> 
<data android:scheme="http" /> 
</intent-filter> 
</activity> 


我 们 在 ThirdActivity 的 <intent-filter> 中 配置 了 当前 活动 能 够 响应 的 action 
是 Intent .ACTION_VIEW 的 常量 值 ， 而 category 则 训 无 疑问 指定 了 默认 的 
category 值 ， 另 外 在 <data> 标签 中 我 们 通过 android:scheme 指定 了 数据 的 
协议 必须 是 http 协 议 ， 这 样 ThirdActivity 应 该 就 和 浏览 器 一 样 ， 能 够 响应 一 
个 打开 网 页 的 Intent 了。 让 我 们 运行 一 下 程序 试 试 吧 ， 在 FirstActivity 的 界面 
点 击 一 下 按钮 ， 结 果 如 图 2.18 所 示 。 


JDen with 
总 Browser 
大 ActivityTest 


JUSTONCE ALWAYS 


图 2.18 ”选择 响应 Intent 的 程序 


可 以 看 到 ， 系 统 上 自动 弹出 了 一 个 列表 ， 显 示 了 目前 能 够 响应 这 个 Intent 的 所 
有 程序 。 选 择 Browser 还 会 像 之 前 一 样 打开 浏览 器 ， 并 显示 百度 的 主页 ， 而 
如 果 选 择 了 ActivityTest， 则 会 启动 ThirdActivity。JUST ONCE 表 示 只 是 这 次 
使 用 选择 的 程序 打开 ，ALWAYS 则 表示 以 后 一 直 都 使 用 这 次 选择 的 程序 打 
开 。 需 要 注意 的 是 ， 虽 然 我 们 声明 了 ThirdActivity 是 可 以 响应 打开 网 页 的 
Intent 的 ， 但 实际 上 这 个 活动 并 没有 加 载 并 显示 网 页 的 功能 ， 所 以 在 真正 的 
项 目 中 尽量 不 要 出 现 这 种 有 可 能 误导 用 户 的 行为 ， 不 然 会 让 用 户 对 我 们 的 
应 用 产生 负面 的 印象 


除了 http 协 议 外 ， 我 们 还 可 以 指定 很 多 其 他 协议 ， 比 如 geo 表 示 显 示 地 理 位 
置 、tel 表 示 拨 打 电 话 。 下 面 的 代码 展示 了 如 何在 我 们 的 程序 中 调用 系统 拨 
号 界面 。 


buttoni1.setOonclickListener(new View.OnClickListener() { 
QOverride 
public void onClick(View v) { 
Intent intent = new Intent(Intent.ACTION_DIAL); 
intent.setData(Uri.parse("tel:10086")); 


startActivity(intent); 


首先 指定 了 Intent 的 action 是 Intent .ACTION_DIAL ， 这 又 是 一 个 Android 系 统 
的 内 置 动作 。 然 后 在 data 部 分 指定 了 协议 是 tel， 号 人 码 是 10086。 重 新 运行 一 
下 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 ， 结 果 如 图 2.19 所 示 。 


+s Create new contact 


名 Addtoacontact 


同 Send SMS 
10086 
1 2 3 
0 
吕 


图 2.19 ”系统 拨号 界面 


2.3.4 ” 问 下 一 个 活动 传递 数据 


经 过 前 面 几 六 的 学 习 ， 人 了 解 。 不 过 到 目前 为 止 ， 
我 们 都 只 是 简单 地 使 用 Intent 来 司 动 一 个 活动 ， 其 实 Intent 还 可 以 在 局 动 活动 
的 时 候 传递 数据 ， 下 面 我 们 来 一 起 看 一 下 。 


在 启动 活动 时 传递 数据 的 思路 很 简单 ，Imtent 中 提供 了 一 系列 putExtra() 方 
法 的 重 载 ， 可 以 把 我 们 想 要 传递 的 数据 暂 存 在 Intent 中 ， 局 动 了 男 一 个 活动 
后 ， 只 需要 把 这 些 数据 再 从 Intent 中 取出 束 可 以 了 。 比 如 说 FirstActivity 中 有 
CO 现在 想 把 这 个 字符 串 传 递 到 SecondActivity 中 ， 你 就 可 以 这 样 
编写 : 


button1.SsetonCclickListener(new View.OnClickListener() { 
Q@Override 
public void onClick(View v) { 
String data = "Hello SecondActivity"; 
Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
intent.putExtra("extra data", data); 


startActivity(intent); 


这 里 我 们 还 是 使 用 显 式 Intent 的 方式 来 局 动 SecondActivity， 并 通过 
putExtra( ) 方法 传递 了 一 个 字符 串 。 注 意 这 里 putExtral( ) 方法 接收 两 个 参 
数 ， 第 一 个 参数 是 键 ， 用 于 后 面 从 Imtent 中 取 健 第 二 个 参数 才 是 真正 要 传 
递 的 数据 。 


然后 我 们 在 SecondActivity 中 将 传递 的 数据 取出 ， 并 打印 出 来 ， 代 码 如 下 所 
示 : 


public class SecondActivity extends AppCompatActivity { 


Q@Override 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.second_ layout); 
Intent intent = getIintent(); 
String data = intent.getStringExtra("extra_ data"); 


Log.d("SecondActivity", data); 


首先 可 以 通过 getIntent() 方法 获取 到 用 于 局 动 SecondActivity 的 Intent， 然 

后 调用 getstringExtra() 方法 ， 传 入 相应 的 键 值 ， 束 可 以 得 到 传递 的 数据 

了 。 这 里 由 于 我 们 传递 的 是 字符 串 ， 所 以 使 用 getstringExtra() 方法 来 获 

取 传 递 的 数据 。 如 果 传 递 的 是 整 型 数据 ， 则 使 用 getIntExtra() 方法 ; 如 果 
传递 的 是 布尔 型 数据 ， 由 | 使 用 getBooleanExtra() 方法 ， 以 此 类 推 。 


重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 会 跳 转 到 
SecondActivity， 查 看 logcat 打 印信 息 ， 如 图 2.20 所 示 。 


Debug 辣 (Q " 


com. example. activitytest D/SecondActivity: Hello SecondActivity 


图 2.20 SecondActivity 中 的 打印 信息 


可 以 看 到 ， 我 们 在 SecondActivity 中 成 功 得 到 了 从 FirstActivity 传 递 过 来 的 数 
据 。 


2.3.5 ”返回 数据 给 上 一 个 活动 


既然 可 以 传递 数据 给 下 一 个 活动 ， 那 么 能 不 能 够 返回 数据 给 上 一 个 活动 
呢 ? 答案 是 肯定 的 。 不 过 不 同 的 是 ， 返 回 上 一 个 活动 只 需要 按 一 下 Back 键 
就 可 以 了 ， 并 没有 一 个 用 于 启动 活动 的 Intent 来 传递 数据 。 通 过 查阅 文档 你 
会 发 现 ，Activity 中 还 有 一 个 startActivityForResult() 方法 也 是 用 于 启动 
活动 的 ， 但 这 个 方法 期 望 在 活动 销毁 的 时 候 能 够 返回 一 个 结果 给 上 一 个 活 
动 。 训 无 疑问 ， 这 允 是 我 们 所 需要 的 。 

startActivityForResult() 方法 接收 两 个 参数 ， 第 一 个 参数 还 是 Intent， 第 


二 个 参数 是 请 求 码 ， 用 于 在 之 后 的 回调 中 判断 数据 的 来 源 。 我 们 还 是 来 实 
战 一 下 ， 修 改 FirstActivity 中 按钮 的 点 击 事件 ， 代 码 如 下 所 示 : 


buttoni1.setoncClickListener(new View.OnClickListener() { 
QOverride 
public void onClick(View v) { 
Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
startActivityForResult(intent, 1); 


这 里 我 们 使 用 了 startActivityForResult() 方法 来 启动 SecondActivity， 请 
求 码 只 要 是 一 个 唯一 值 就 可 以 了 ， 这 里 传 入 了 1。 接 下 来 我 们 在 
SecondActivity 中 给 按钮 注册 点 击 事件 ， 并 在 点 击 事件 中 添加 返回 数据 的 逻 
辑 ， 代 码 如 下 所 示 : 


public class SecondActivity extends AppCompatActivity { 


QOverride 
protected void onCreate(Bundle savedIinstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.second_ layout); 
Button button2 = (Button) findViewById(R.id.button 2); 
button2 ,SetonCclickListener(new View.OnClickListener() { 
@Override 
public void oncClick(View v) { 
Intent intent = new Intent(); 
intent.putExtra("data_return", "Hello FirstActivity"); 
setResult (RESULT_OK, intent); 
finish(); 
} 


可 以 看 到 ， 我 们 还 是 构建 了 一 个 Intent， 只 不 过 这 个 Intent 仅 仅 是 用 于 传递 数 
据 而 已 ， 它 没有 指定 任何 的 “意图 ”。 紧 接着 把 要 传递 的 数据 存放 在 Intent 
中 ， 然 后 调用 了 setResult() 方法 。 这 个 方法 非常 重要 ， 是 专门 用 于 同上 一 
个 活动 返回 数据 的 。setResult() 方法 接收 两 个 参数 ， 第 一 个 参数 用 于 同上 
一 个 活动 返回 处 理 结 果 ， 一 般 只 使 用 RESULT_oK 或 RESULT_CANCELED 这 两 个 
值 ， 第 二 个 参数 则 把 带 有 数据 的 Intent 传 递 回去 ， 然 后 调用 了 finish() 方法 
来 销毁 当前 活动 。 


由 于 我 们 是 使 用 Sa ttre () 方法 来 启动 SecondActivity 的 ， 
在 SecondActivity 被 销毁 之 后 会 回调 上 一 个 活动 的 onActivityResult() 方 
法 ， 因 此 我 们 需要 在 FirstActivity 中 重 写 这 个 方法 来 得 到 返回 的 数据 ， 如 下 
所 示 : 


Q@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
switch (requestCode) { 
case 1: 
if (resultCode == RESULT_OK) { 
String returnedData = data.getStringExtra("data_return"); 
Log.d("FirstActivity", returnedData); 


} 
break; 
default: 


| 
onActivityResult() 方法 带 有 二 个 参数 ， 第 一 个 参数 requestcode ， 即 我 们 
在 启动 活动 时 传 入 的 请 求 码 。 第 二 个 参数 resultcode ， 即 我 们 在 返回 数据 
时 传 入 的 处 理 结果 。 第 三 个 参数 data ， 即 携带 着 返回 数据 的 Intent。 由 于 在 
一 个 活动 中 有 可 能 调用 startActivityForResult() 方法 去 启动 很 多 不 同 的 活 
动 ， 每 一 个 活动 返回 的 数据 都 会 回调 到 onActivityResult() 这 个 方法 中 ， 
因此 我 们 首先 要 做 的 就 是 通过 检查 requestcode 的 值 来 判断 数据 来 源 。 确 定 
数据 是 从 SecondActivity 返 回 的 之 后 ， 我 们 再 通过 resultcode 的 值 来 判断 处 
理 结果 是 否 成 功 。 最 后 从 data 中 取 值 并 打印 出 来 ， 这 样 就 完成 了 向 上 一 个 
活动 返回 数据 的 工作 。 

重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 按钮 会 打开 SecondActivity， 然 后 


在 SecondActivity 界 面 点 击 Button 2 按钮 会 回 到 FirstActivity， 这 时 查看 logcat 
的 打印 信息 ， 如 图 2.21 所 示 。 
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com. example. activitytest D/FirstActivity: Hello FirstActivity 
图 2.21 FirstActivity 中 的 打印 信息 
可 以 看 到 ，SecondActivity 已 经 成 功 返 回 数 据 给 FirstActivity 了 。 
这 时 候 你 可 能 会 问 ， 如 果 用 户 在 SecondActivity 中 并 不 是 通过 点 击 按钮 ， 而 
是 通过 按 下 Back 键 回 到 FirstActivity， 这 样 数据 不 就 没 法 返回 了 吗 ? 没 错 ， 


不 过 这 种 情况 还 是 很 好 处 理 的 ， 我 们 可 以 通过 在 SecondActivity 中 重 写 
onBackPressed() 方法 来 解决 这 个 问题 ， 代 码 如 下 所 示 : 


Q@Override 

public void onBackPressed() { 
Intent intent = new Intent(); 
intent.putExtra("data_return", "Hello FirstActivity"); 
setResult(RESULT_OK, intent); 
finish(); 


这 样 的 话 ， 当 用 户 按 下 Back 键 ， 就 会 去 执行 onBackPressed() 方法 中 的 代 
码 ， 我 们 在 这 里 添加 返回 数据 的 逻辑 就 行 了 。 


2.4 活动 的 生命 周期 


掌握 活动 的 生命 周期 对 任何 Android 开 发 者 来 说 都 非常 重要 ， 当 你 深入 理解 
活动 的 生命 周期 之 后 ， 束 可 以 写 出 更 加 连贯 流畅 的 程序 ， 并 在 如 何 合理 管 
理应 用 资源 方面 发 挥 得 游 孝 有余。 你 的 应 用 程序 将 会 拥有 更 好 的 用 户 体 
验 。 


2.4.1 返回 栈 


经 过 前 面 几 节 的 学 习 ， 我 相信 你 已 经 发 现 了 这 一 点 ，Android 中 的 活动 是 可 
以 层 且 的。 我 们 每 司 动 一 个 新 的 活动 ， 驶 会 履 兰 在 原 活动 之 上 ， 然 后 点 击 
Back 刍 会 销 虹 最 上 面 的 活动 ， 下 面 的 一 个 活动 束 会 重新 显示 出 来 。 


其 实 Android 是 使 用 任务 (Task) 来 管理 活动 的 ， 一 个 任务 就 是 一 组 存放 在 
栈 里 的 活动 的 集合 ， 这 个 栈 也 被 称 作 返回 栈 (Back Stack) 。 栈 是 一 种 后 进 
先 出 的 数据 结构 ， 在 默认 情况 下 ， 每 当 我 们 启动 了 一 个 新 的 活动 ， 它 会 在 
返回 栈 中 入 栈 ， 并 处 于 栈 顶 的 位 置 。 而 每 当 我 们 按 下 Back 键 或 调用 

finish() 方法 去 销 驶 一 个 活动 时 ， 处 于 栈 顶 的 活动 会 出 栈 ， 这 时 前 一 个 入 
人 


示意 图 2.22 展 示 了 返回 栈 是 如 何 管理 活动 入 栈 出 栈 操 作 的 。 


启动 一 个 新 活动 


将 栈 顶 活动 移 除 
启动 的 活动 
启动 的 活动 


返回 栈 


图 2.22 返回 栈 工作 示意 图 
2.4.2 ”活动 状态 


每 个 活动 在 其 生命 周期 中 最 多 可 能 会 有 4 种 状态 。 
01. 运行 状态 


当 一 个 活动 位 于 返回 栈 的 栈 顶 时 ， 这 时 活动 束 处 于 运行 状态 。 系 统 最 
人 
验 。 


02. 暂停 状态 


当 一 个 活动 不 再 处 于 栈 顶 位 置 ， 但 仍然 可 见 时 ， 这 时 活动 束 进 入 了 暂 
停 状 态 。 你 可 能 会 觉得 既然 活动 已 经 不 在 栈 顶 了 ， 还 怎么 会 可 见 呢 ? 
这 是 因为 并 不 古 每 一 个 活动 部 会 占 满 整 个 屏幕 的 ， 比 如 对 话 框 形式 的 
活动 只 会 占用 屏幕 中 间 的 部 分 区 域 ， 你 很 快 整 会 在 后 面 看 到 这 种 活 

动 。 处 于 暂停 状态 的 活动 仍然 是 完全 存活 着 的 ， 系 统 也 不 愿意 去 回收 
这 种 活动 (因为 它 还 是 可 见 的 ， 回 收 可 见 的 东西 都 会 在 用 户 体验 方面 


人 ， 只 有 在 内 存 极 低 的 情况 下 ， 系 统 才 会 去 考虑 回收 这 
种 活动 。 


03. 停止 状态 


当 一 个 活动 不 再 处 于 栈 顶 位 置 ， 并 且 完 全 不 可 见 的 时 候 ， 就 进入 了 停 
止 状态 。 系 统 仍然 会 为 这 种 活动 保存 相应 的 状态 和 成 员 变 量 ， 但 是 这 
并 不 是 完全 可 靠 的 ， 当 其 他 地 方 需要 内 存 时 ， 处 于 停止 状态 的 活动 有 
可 能 会 被 系统 回收 。 


04. 销毁 状态 


当 一 个 活动 从 返回 栈 中 移 除 后 就 变 成 了 销毁 状态 。 系 统 会 最 倾 问 于 回 
收 处 于 这 种 状态 的 活动 ， 从 而 保证 手机 的 内 存 充足 。 


2.4.3 ”活动 的 生存 期 


Activity 类 中 定义 了 7 个 回调 方法 ， 禾 盖 了 活动 生命 周期 的 每 一 个 环 订 ， 下 面 
就 来 一 一 介绍 这 7 个 方法 。 


。 oncreate() 。 这 个 方法 你 已 经 看 到 过 很 多 次 了 ， 每 个 活动 中 我 们 都 重 
写 了 这 个 方法 ， 它 会 在 活动 第 一 次 被 创建 的 时 候 调用 。 你 应 该 在 这 个 
方法 中 完成 活动 的 初始 化 操作 ， 比 如 说 加 载 布局 、 绑 定 事件 等 。 


。 onstart() 。 这 个 方法 在 活动 由 不 可 见 变 为 可 见 的 时 候 调 用 。 


。 onResume() 。 这 个 方法 在 活动 准备 好 和 用 户 进 行 交 互 的 时 候 调 用 。 此 
时 的 活动 一 定位 于 返回 栈 的 栈 顶 ， 并 且 处 于 运行 状态 。 


onPause() 。 这 个 方法 在 系统 准备 去 局 动 或 者 恢复 另 一 个 活动 的 时 候 调 
用 。 我 们 通常 会 在 这 个 方法 中 将 一 些 消 耗 CPU 的 资源 释放 掉 ， 以 及 保 
存 一 些 天 键 数 据 ， 但 这 个 方法 的 执行 速度 一 定 要 快 ， 不 然 会 影响 到 新 
的 栈 顶 活动 的 使 用 。 


。 onstop() 。 这 个 方法 在 活动 完全 不 可 见 的 时 候 调 用 。 它 和 onpause( ) 方 
法 的 主要 区 别 在 于 ， 如 有 果 启 动 的 新 活动 是 一 个 对 话 框 式 的 活动 ， 那 么 
onPause() 方法 会 得 到 执行 ， 而 onstop() 方法 并 不 会 执行 2 


onpDestroy() 。 这 个 方法 在 活动 被 销 哎 之 前 调用 ， 之 后 活动 的 状态 将 变 
为 销 哎 状态 。 


onRestart() 。 这 个 方法 在 活动 由 停止 状态 变 为 运行 状态 之 前 调用 ， 也 
忠 是 活动 被 重新 局 动 了 。 


以 上 7 个 方法 中 除了 onRestart() 方法 ， 其 他 都 征 两 两 相对 的 ， 从 而 又 可 以 
将 活动 分 为 3 种 生存 期 。 


完整 生存 期 。 活 动 在 oncreate( ) 方法 和 onpestroy() 方法 之 间 所 经 历 
的 ， 就 是 完整 生存 期 。 一 般 情况 下 ， 一 个 活动 会 在 oncreate() 方法 中 
完成 各 种 初始 化 操作 ， 而 在 onpestroy() 方法 中 完成 释放 内 存 的 操作 。 


可 见 生存 期 。 活 动 在 onstart() 方法 和 onstop() 方法 之 间 所 经 历 的 ， 
束 是 可 见 生 存 期 。 在 可 见 生 存 期 内 ， 活 动 对 于 用 户 总 是 可 见 的 ， 即 便 
有 可 能 无 法 和 用 户 进 行 交 互 。 我 们 可 以 通过 这 两 个 方法 ， 合 理 地 管理 
那些 对 用 户 可 见 的 资源 。 比 如 在 onstart() 方法 中 对 资源 进行 加 载 ， 而 
在 onstop() 方法 中 对 资源 进行 释放 ， 从 而 保证 处 于 停止 状态 的 活动 不 
会 占用 过 多 内 存 。 


前 台 生 存 期 。 活 动 在 onResume() 方法 和 onpause( ) 方法 之 间 所 经 历 的 就 
是 前 台 生 存 期 。 在 前 台 生 存 期 内 ， 活 动 总 是 处 于 运行 状态 的 ， 此 时 的 
活动 是 可 以 和 用 户 进行 交互 的 ， 我 们 平时 看 到 和 接触 最 多 的 也 就 是 这 
个 状态 下 的 活动 。 


为 了 帮助 你 能 够 更 好 地 理解 ，Android 官 方 提 供 了 一 张 活 动 生命 周期 的 示意 
图 ， 如 图 2.23 所 示 。 
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图 2.23 活动 的 生命 周期 
2.4.4 ”体验 活动 的 生命 周期 


讲 了 这 么 多 理论 知识 ， 也 是 时 候 该 实战 一 下 了 ， 下 面 我 们 将 通过 一 个 实 
例 ， 让 你 可 以 更 加 直观 地 体验 活动 的 生命 周期 。 


这 次 我 们 不 准备 在 ActivityTest 这 个 项 目的 基础 上 修改 了 ， 而 是 新 建 一 个 项 
目 。 因 此 ， 首 移 天 闭 ActivityTest 项 目 ， 点 击 导 航 栏 File Close Project。 然 后 
再 新 建 一 个 ActivityLifeCycleTest 项 目 ， 新 建 项 目的 过 程 你 应 该 已 经 非常 清 
楚 了 ， 不 需要 我 再 进行 资 述 ， 这 次 我 们 允许 Android Studio 帮 我 们 目 动 创建 
活动 布局， 这 这 样 可 以 省 去 不 少 工作 ， 创 建 的 活动 名 和 布局 名 都 使 用 默认 


这 样 主 活动 就 创建 完成 了 ， 我 们 还 需要 分 别 再 创建 两 个 子 活动 
NormalActivity 和 DialogActivity， 下 面 一 步 步 来 实现 。 


右 击 com.example.activitylifecycletest 包 -New Activity Empty Activity， 新 
建 NormalActivity， 布 局 起 名 为 normal_layout。 然 后 使 用 同样 的 方式 创建 
DialogActivity， 布 局 起 名 为 dialog_layout 。 


现在 编辑 normal layout,xzml 文 件 ， 将 里 面 的 代码 奉 换 成 如 下 内 容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="This is a normal activity" 
/> 


</LinearLayout> 


个 布局 中 我 们 就 非常 简单 地 使 用 了 一 个 TextView， 用 于 显示 一 行文 字 ， 在 
下 一 章 中 你 将 会 学 到 更 多 关于 TextView 的 用 法 。 


然后 再 编辑 dialog_layout.xml 文 件 ， 将 里 面 的 代码 替换 成 如 下 内 容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="This is a dialog activity" 


/> 


</LinearLayout> 


两 个 布局 文件 的 代码 几乎 没有 区 别 ， 只 是 显示 的 文字 不 同 而 已 。 


NormalActivity 和 DialogActivity 中 的 代码 我 们 保持 默认 就 好 ， 不 需要 改动 。 


其 实 从 名 字 上 你 就 可 以 看 出 ， 这 两 个 活动 一 个 是 普通 的 活动 ， 一 个 是 对 话 
框 式 的 活动 。 可 是 我 们 并 没有 修改 活动 的 任何 代码 ， 两 个 活动 的 代码 应 该 
几乎 是 一 模 一 样 的 ， 在 哪里 有 体现 出 将 活动 设 成 对 话 框 式 的 呢 ? 别 着 急 ， 
下 面 我 们 马上 开始 设置 。 修 改 AndroidManifest.xml 的 <activity> 标签 的 配 
置 ， 如 下 所 示 : 


<activity android:name=".NormalActivity"> 

</activity> 

<activity android:name=".DialogActivity" 
android:theme="@style/Theme.AppCompat .Dialog"> 


</activity> 


这 里 是 两 个 活动 的 注册 代码 ， 但 是 DialogActivity 的 代码 有 些 不 同 ， 我 们 给 
它 使 用 了 一 个 android:theme 属性 ， 这 是 用 于 给 当前 活动 指定 主题 的 ， 
Android 系 统 内 置 有 很 多 主题 可 以 选择 ， 当 然 我 们 也 可 以 定制 自己 的 主题 ， 
而 这 里 @style/Theme .AppCcompat ,Dialog 则 宣 无 疑问 是 让 DialogActivity 使 用 
对 话 框 式 的 主题 。 


接 下 来 我 们 修改 activity_main.xml， 重 新 定制 主 活动 的 布局 ， 将 里 面 的 代码 
蔡 换 成 如 下 内 容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/start_normal activity" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Start NormalActivity" /> 


<Button 
android:id="@+id/start_dialog activity" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Start DialogActivity" /> 


</LinearLayout> 


可 以 看 到 ， 我 们 在 LinearLayout 中 加 入 了 两 个 按钮 ， 一 个 用 于 启动 
NormalActivity， 一 个 用 于 局 动 DialogActivity。 


最 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
public static final String TAG = "MainActivity"; 


Q@Override 
protected void onCreate(Bundle SavedInstanceState) { 
Super .oncCreate(SavedInstanceState ) 
Log.d(TAG, "onCreate"); 
setcontentView(R.1layout.activity_main); 
Button startNormalActivity = (Button) findViewById(R.id,.start_normal_ 
activity); 
Button startDialogActivity = (Button) findViewById(R.id.start_dialog 
activity); 
startNormalActivity.setOonclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent(MainActivity.this, NormalActivity.class); 
startActivity(intent); 
} 
}); 


startDialogActivity.setOoncClickListener(new View.OnClickListener() { 
Q@Override 


public void onClick(View v) { 


Intent intent = new Intent(MainActivity.this, DialogActivity.class); 
startActivity(intent); 


和 7 
} 


QOverride 

protected void onStart() { 
super .onSstart(); 
Log.d(TAG, "onStart"); 


QOverride 

protected void onResume() { 
super .onResume(); 
Log.d(TAG, "onResume"); 

} 


QOverride 

protected void onPause() { 
super .onpause( ); 
Log.d(TAG, "onPause"); 

} 


Q@Override 

protected void onStop() { 
super .onStop() ， 
Log.d(TAG, "onStop"); 


} 


Q@Override 

protected void onDestroy() { 
super .onDestroy(); 
Log.d(TAG, "onDestroy"); 


Q@Override 

protected void onRestart() { 
super .onRestart(); 
Log.d(TAG, "onRestart"); 


在 oncreate() 方法 中 ， 我 们 分 别 为 两 个 按钮 注册 了 点 击 事件 ， 点 击 第 
按钮 会 启动 NormalActivity， 点 击 第 二 个 按钮 会 局 ee ° 0 在 
Activity 的 7 个 回调 方法 中 分 别 打 印 了 一 句 话 ， 这 样 天 可 以 通过 观察 日 志 的 方 
式 来 更 直观 地 理解 活动 的 生命 周期 。 


现在 运行 程序 ， 效 果 如 图 2.24 所 示 。 


ActivityLifeCycleTest 
START NORMALACTIVITY 


START DIALOGACTIVITY 


图 2.24 MainActivity 界 面 


这 时 观察 logcat 中 的 打印 日 志 ， 如 图 2.25 所 示 。 


Verbose 图 (Qr 


com. example. activitylifecycletest D/MainActivity: onCreate 
com. example. activitylifecycletest D/MainActivity: onStart 


com. example. activitylifecycletest D/MainActivity: onResume 


图 2.25 ”启动 程序 时 的 打印 日 志 


可 以 看 到 ， 当 MainActivity 第 一 次 被 创建 时 会 依次 执行 oncreate() 、 
onstart() 和 onResume( ) 方法 。 然 后 点 击 第 一 个 按钮 ， 启 动 
NormalActivity， 如 图 2.26 所 示 。 


ActivityLifeCycleTest 


图 2.26 NormalActivity 界 面 


此 时 的 打印 信息 如 图 2.27 所 示 。 


Pp ， 
| Verbose 图 (Q- ) 


com. example. activitylifecycletest D/MainActivity: onPause 


com. example. activitylifecycletest D/MainActivity: onStop 


图 2.27 打开 NormalActivity 时 的 打印 日 志 


由 于 NormalActivity 已 经 把 MainActivity 完 全 让 挡住 ， 因 此 onpPause() 和 
onstop() 方法 都 会 得 到 执行 。 然 后 按 下 Back 键 返回 MainActivity， 打 印信 息 
如 图 2.28 所 示 。 


Verbose 图 (Qa: 


com. example. activitylifecycletest D/MainActivity: onRestart 


com. example. activitylifecycletest D/MainActivity: onStart 


com. example. activitylifecycletest D/MainActivity: onResume 
图 2.28 返回 MainActivity 的 打印 日 志 
由 于 之 前 MainActivity 已 经 进入 了 停止 状态 ， 所 以 onRestart() 方法 会 得 到 
执行 ， 之 后 又 会 依次 执行 onstart() 和 onResume() 方法 。 注 意 此 时 
oncreate( ) 方法 不 会 执行 ， 因 为 MainActivity 并 没有 重新 创建 。 


然后 再 点 击 第 二 个 按钮 ， 启 动 DialogActivity， 如 图 2.29 所 示 。 


ActivityLifeCycleTest 
adialog actvity 


图 2.29 DialogActivity 界 面 


此 时 观察 打印 信息 ， 如 图 2.30 所 示 。 


| Verbose 留 Qr 


com. example. activitylifecycletest D/MainActivity: onPause 


图 2.30 打开 DialogActivity 时 的 打印 日 志 


可 以 看 到 ， 只 有 onPause() 方法 得 到 了 执行 ，onstop() 方法 并 没有 执行 ， 这 
是 因为 DialogActivity 并 没有 完全 扩 挡 住 MainActivity， 此 时 MainActivity 只 是 
进入 了 暂停 状态 ， 并 没有 进入 停止 状态 。 相 应 地 ， 按 下 Back 键 返回 
MainActivity 也 应 该 只 有 onResume() 方法 会 得 到 执行 ， 如 图 2.31 所 示 。 


| Verbose 加 Q- 


com. example. activitylifecycletest D/MainActivity: onResume 


图 2.31 再 次 返回 MainActivity 的 打印 日 志 
最 后 在 MainActivity 按 下 Back 键 退出 程序 ， 打 印信 息 如 图 2.32 所 示 。 


Verbose 图 IQr 


com. example. activitylifecycletest D/MainActivity: onPause 
com. example. activitylifecycletest D/MainActivity: onStop 


com. example. activitylifecycletest D/MainActivity: onDestroy 


图 2.32 退出 程序 时 的 打印 日 志 


依次 会 执行 onPause() 、onstop() 和 onDestroy() 方法 ， 最 终 销 毁 
MainActivity ° 


这 样 活动 完整 的 生命 周期 你 已 经 体验 了 一 这， 是 不 是 理解 得 更 加 深刻 了 ? 


2.4.5 ”活动 被 回收 了 怎么 办 


前 面 我 们 已 经 说 过 ， 当 一 个 活动 进入 到 了 停止 状态 ， 是 有 可 能 被 系统 回收 
的 。 那 么 想象 以 下 场景 : 应 用 中 有 一 个 活动 A， 用 户 在 活动 A 的 基础 上 启动 
了 活动 B， 活 动 A 就 进入 了 停止 状态 ， 这 个 时 候 由 于 系统 内 存 不 足 ， 将 活动 
A 回收 挤 了 ， 然 后 用 户 按 下 Back 键 返回 活动 A， 会 出 现 什么 情况 呢 ? 其实 还 
征 会 正 肖 显示 活动 A 的 ， 只 不 过 这 时 并 不 会 执行 onRestart() 方法 ， 而 是 会 
执行 活动 A 的 oncreate() 方法 ， 因 为 活动 A 在 这 种 情况 下 会 被 重新 创建 一 
次 。 


这 样 看 上 去 好 像 一 切 正 常 ， 可 是 别 忽略 了 一 个 重要 问题 ， 活 动 A 中 是 可 能 存 
在 临时 数据 和 状态 的 。 打 个 比方 ，MainActivity 中 有 一 个 文本 输入 框 ， 现 在 
你 输入 了 一 段 文字 ， 然 后 局 动 NormalActivity， 这 时 MainActivity 由 于 系统 内 
存 不 足 被 回收 掉 ， 过 了 一 会 你 又 点 击 了 Back 键 回 到 MainActivity， 你 会 发 现 
刚刚 输入 的 文字 全 部 都 没 了 ， 因 为 MainActivity 币 重新 创建 了 。 


如 果 我 们 的 应 用 出 现 了 这 种 情况 ， 是 会 严重 影响 用 户 体验 的 ， 所 以 必须 要 
想 想 办 法 解决 这 个 问题 。 查 阅 文档 可 以 看 出 ，Activity 中 还 提供 了 一 个 
onSsaveInstancestate() 回调 方法 ， 这 个 方法 可 以 保证 在 活动 被 回收 之 前 一 
定 会 被 调用 ， 因 此 我 们 可 以 通过 这 个 方法 来 解决 活动 被 回收 时 I 临 时 数据 得 
不 到 保存 的 问题 。 


onSaveInstanceState( ) 方法 会 携带 一 个 Bundle 类 型 的 参数 ，Bundle 提供 了 

一 系列 的 方法 用 于 保存 数据 ， 比 如 可 以 使 用 putstring() 方法 保存 字 
使 用 putInt() 方法 保存 整 型 数据 ， 以 此 类 推 。 每 个 保存 方法 需要 传 入 两 个 
参数 ， 第 一 个 参数 是 键 ， 用 于 后 面 从 Bundle 中 取 值 ， 第 二 个 参数 是 真正 要 
保存 的 内 容 。 


在 MainActivity 中 添加 如 下 代码 束 可 以 将 临时 数据 进行 保存 : 


Q@Override 

protected void onSaveInstanceState(Bundle outState) { 
super .onSaveInstanceState(outState ) ， 
String tempData = "Something you just typed"; 
outState,.putString("data_key"”，tempData) ， 


} 


数据 是 已 经 保存 下 来 了 ， 那 么 我 们 应 该 在 哪里 进行 恢复 呢 ? 细心 的 你 也 许 
早 就 发 现 ， 我 们 一 直 使 用 的 oncreate( ) 方法 其 实 也 有 一 个 Bundle 类 型 的 参 
数 。 这 个 参数 在 一 般 情况 下 都 是 nu1l1 ， 但 是 如 果 在 活动 被 系统 回收 之 前 有 
通过 onsaveInstancestate() 方法 来 你 存 数据 有 的话， 这 个 参数 就 会 带 有 之 前 
所 保存 的 全 部 数据 ， 我 们 只 需要 再 通过 相应 的 取 值 方法 将 数据 取出 即 可 。 


修改 MainActivity 的 oncreate() 方法 ， 如 下 所 示 : 


Q@override 
protected void onCreate(Bundle SavedInstanceState) { 
super .onCreate(savedInstanceState); 
Log.d(TAG, "onCreate"); 
setCcontentView(R.Jlayout.activity_main); 
if (SavedInstanceState != null) 
String tempData = savedInstanceState.getString("data_ key"); 


Log.d(TAG, tempData); 


取出 值 之 后 再 做 相应 的 恢复 操作 就 可 以 了 ， 比 如 说 将 文本 内 容重 新 赋值 到 
文本 输入 框 上 ， 这 里 我 们 只 是 简单 地 打印 一 下 。 


不 知道 你 有 没有 察觉 ， 使 用 Bundle 来 保存 和 取出 数据 是 不 是 有 些 似曾相识 
呢 ? 没 错 ! 我 们 在 使 用 Intent 传 递 数据 时 也 是 用 的 类 似 的 方法 。 这 里 跟 你 提 
桓 一 点 ，Intent 还 可 以 结合 Bundle 一 起 用 于 传递 数据 ， 首 先 可 以 把 需要 传递 
的 数据 都 保存 在 Bundle 对 象 中 ， 然 后 再 将 Bundle 对 象 存放 在 Intent 里 。 到 了 


目标 活动 之 后 先 从 Intent 中 取出 Bundle ， 再 从 Bundle 中 一 一 取出 数据 。 具 体 
的 代码 我 束 不 写 了 ， 要 学 会 举一反三 哦 。 


2.5 ”活动 的 局 动 模式 


活动 的 局 动 模式 对 你 来 说 应 该 是 个 全 新 的 概念 ， 在 实际 项 目 中 我 们 应 该 根 
据 特 定 的 需求 为 每 个 活动 指定 恰当 的 启动 模式 。 启 动 模式 一 共有 4 种 ， 分 别 
是 standard、singleTop、singleTask 和 singleInstance， 可 以 在 
AndroidManifest,xml 中 通过 给 <activity> 标签 指定 android:1aunchMode 属性 
来 选择 局 动 模式 。 下 面 我 们 来 逐个 进行 学 习 。 


2.5.1 standard 


standard 是 活动 默认 的 启动 模式 ， 在 不 进行 显 式 指定 的 情况 下 ， 所 有 活动 都 
会 自动 使 用 这 种 启动 模式 。 因 此 ， 到 目前 为 止 我 们 写 过 的 所 有 活动 都 是 使 
用 的 standard 模 式 。 经 过 上 一 节 的 学 习 ， 你 已 经 知道 了 Android 是 使 用 返回 栈 
来 管理 活动 的 ， 在 standard 模 式 《 即 默认 情况 ) 下 ， 每 当 启动 一 个 新 的 活 
动 ， 它 束 会 在 返回 栈 中 入 栈 ， 并 处 于 栈 顶 的 位 置 。 对 于 使 用 standard 模 式 的 
活动 ， 系 统 不 会 在 乎 这 个 活动 是 否 已 经 在 返回 栈 中 存在 ， 每 次 启动 都 会 创 
建 该 活动 的 一 个 新 的 实例 。 

我 们 现在 通过 实践 来 体会 一 下 standard 模 式 ， 这 次 还 是 准备 在 ActivityTest 项 
目的 基础 上 修改 ， 首 先 关 闭 ActivityLifeCycleTest 项 目 ， 打 开 ActivityTest 项 
目 o 


修改 FirstActivity 中 oncreate() 方法 的 代码 ， 如 下 所 示 : 


Q@Override 
protected void onCreate(Bundle SavedInstanceState) { 
super .onCreate(savedInstanceState); 
Log.d("FirstActivity", this.tostring()); 
setcontentView(R.Jlayout.first_layout); 
Button button1 = (Button) findViewById(R.id.button_1); 
button1.setOonCclickListener(new View.OnClickListener() { 
Q@Override 
public void oncClick(View v) { 
Intent intent = new Intent(FirstActivity.this, FirstActivity.class); 
StartActivity(intent ) ， 


} 
}); 


代码 看 起 来 有 些 奇怪 吧 ， 在 FirstActivity 的 基础 上 启动 FirstActivity。 从 逻辑 
上 来 讲 这 确实 没什么 意义 ， 不 过 我 们 的 重点 在 于 研究 standard 模 式 ， 因 此 不 
必 在 意 这 段 代 码 有 什么 实际 用 途 。 男 外 我 们 还 在 oncreate( ) 方法 中 添加 了 
一 行 打 印信 息 ， 用 于 打印 当前 活动 的 实例 。 


现在 重新 运行 程序 ， 然 后 在 FirstActivity 界 面 连续 点 击 两 次 按钮 ， 可 以 看 到 
logcat 中 打印 信息 如 图 2.33 所 示 。 


Debug 图 Qr Regex | FirstActivity 


com. example. activitytest D/FirstActivity: com. example.activitytest.FirstActivity@7?1b88c5 
com. example. activitytest D/FirstActivity: com. example.activitytest.FirstActivity@37b39291 


com. example. activitytest D/FirstActivity: com. example.activitytest.FirstActivity@20309892 


图 2.33 standard 模 式 下 的 打印 日 志 

从 打印 信息 中 我 们 就 可 以 看 出 ， 每 点 击 一 次 按钮 就 会 创建 出 一 个 新 的 
FirstActivity 实 例 。 此 时 返回 栈 中 也 会 存在 3 个 FirstActivity 的 实例 ， 因 此 你 需 
要 连 按 3 次 Back 键 才能 退出 程序 。 


standard 模 式 的 原理 示意 图 ， 如 图 2.34 所 示 。 


启动 新 活动 


启动 新 活动 


返回 栈 
图 2.34 standard 模 式 示意 图 


2.5.2 singleTop 


EB 在 有 些 情况 下 ， 你 会 觉得 standard 模 式 不 太 合 理 。 活 动 明明 已 经 在 栈 顶 
了 ， 为 什么 再 次 局 动 的 时 候 还 要 创建 一 个 新 的 活动 实例 呢 ? 别 着 急 ， 这 只 
是 系统 默认 的 一 种 启动 模式 而 已 ， 你 完全 可 以 根据 自己 的 需要 进行 修改 ， 
比如 说 使 用 singleTop 模 式 。 当 活动 的 局 动 模式 指定 为 singleTop， 在 局 动 活 动 
时 如 有 果 发 现 返回 栈 的 栈 顶 已 经 是 该 活动 ， 则 认为 可 以 直接 使 用 它 ， 不 会 再 
创建 新 的 活动 实例 。 


我 们 还 是 通过 实践 来 体会 一 下 ， 修 改 AndroidManifest.xml 中 FirstActivity 的 局 
动 模式 ， 如 下 所 示 : 


<activity 
android:name=" .FirstActivity" 
android:launchMode="singleTop" 
android:]label="This is FirstActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


然后 重新 运行 程序 ， 查 看 logcat 会 看 到 已 经 创建 了 一 个 FirstActivity 的 实例 ， 
如 图 2.35 所 示 。 


Debug 图 Dr> Regex | FirstActivity 


com. example. activitytest D/FirstActivity: com. example.activitytest.FirstActivity@2cd53c9f 


图 2.35 singleTop 模 式 下 的 打印 日 志 


但 是 之 后 不 管 你 点 击 多 少 次 按钮 都 不 会 再 有 新 的 打印 信息 出 现 ， 因 为 目前 
FirstActivity 已 经 处 于 返回 栈 的 栈 顶 ， 每 当 想 要 再 局 动 一 个 FirstActivity 时 都 
会 直接 使 用 栈 顶 的 活动 ， 因此 FirstActivity 也 只 会 有 一 个 实例 ， 仅 按 一 
Back 键 就 可 以 退出 程序 。 


不 过 当 FirstActivity 并 未 处 于 栈 顶 位 置 时 ， 这 时 再 启动 FirstActivity， 还 是 会 
创建 新 的 实例 的 。 


下 面 我 们 来 实验 一 下 ， 修 改 FirstActivity 中 oncreate() 方法 的 代码 ， 如 下 所 
人 小 : 


Q@override 
protected void onCreate(Bundle SavedInstanceState) { 
super .onCreate(savedInstanceState); 
Log.d("FirstActivity", this.tostring()); 
setcontentView(R.Jlayout.first_layout); 
Button button1 = (Button) findViewById(R.id.button_ 1); 
buttoni1.setOoncClickListener(new View.OnClickListener() { 
Q@Override 
public void onClick(View v) { 
Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
startActivity(intent); 


这 次 我 们 点 击 按钮 后 启动 的 是 SecondActivity。 然 后 修改 SecondActivity 中 
oncreate( ) 方法 的 代码 ， 如 下 所 示 : 


Q@Override 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstancestate); 
Log.d("SecondActivity", this.tostring()); 
setcontentView(R.1layout.second_ layout); 
Button button2 = (Button) findViewById(R.id.button 2); 
button2 .SetOonCclickListener(new View.OnClickListener() { 
Q@Override 
public void onClick(View v) { 


Intent intent = new Intent(SecondActivity.this, FirstActivity.class); 
startActivity(intent); 


我 们 在 SecondActivity 中 的 按钮 点 击 事件 里 又 加 入 了 启动 FirstActivity 的 代 
码 。 现 在 重新 运行 程序 ， 在 FirstActivity 界 面 点 击 按钮 进入 到 
SecondActivity， 然 后 在 SecondActivity 界 面 点 击 按钮 ， 又 会 重 靳 进入 到 
FirstActivity ° 


查看 logcat 中 的 打印 信息 ， 如 图 2.36 所 示 。 


Debug 加 6 Activity: Regex | Show only 


com. example. activitytest D/FirstActivity: com. example.activitytest.FirstActivity@2cd53c9f 
com. example. activitytest D/SecondActivity: com. example.activitytest. SecondActivity@3c50d14 


com. example. activitytest D/FirstActivity: com. example. activitytest. FirstActivity@215dbad3 


图 2.36 ”singleTop 模 式 下 的 打印 日 志 


可 以 看 到 系统 创建 了 两 个 不 同 的 FirstActivity 实 例 ， 这 是 由 于 在 
SecondActivity 中 再 次 启动 FirstActivity 时 ， 栈 顶 活动 已 经 变 成 了 
SecondActivity， 因 此 会 创建 一 个 新 的 FirstActivity 实 例 。 现 在 按 下 Back 键 会 
返回 到 SecondActivity， 再 次 按 下 Back 键 又 会 回 到 FirstActivity， 再 按 一 次 
Back 键 才 会 退出 程序 。 


singleTop 模 式 的 原理 示意 图 ， 如 图 2.37 所 示 。 


检查 栈 顶 判 


是否 需要。 人 


局 动 新 活动 


启动 新 活动 


图 2.37 singleTop 模 式 示意 图 


2.5.3 singleTask 


使 用 singleTop 模 式 可 以 很 好 地 解决 重复 创建 栈 顶 活动 的 问题 ,但 是 正如 你 
在 上 一 节 所 看 到 的 ， 如 果 该 活动 并 没有 人 处 于 栈 顶 的 位 置 ， 还 是 可 能 会 创建 
多 个 活动 实例 的 。 那 么 有 没有 什么 办 法 可 以 让 某 个 活动 在 整个 应 用 程序 的 
上 下 文中 只 存在 一 个 实例 呢 ? 这 束 要 借助 singleTask 模 式 来 实现 了 。 当 活动 
的 局 动 模式 指定 为 singleTask， 每 次 局 动 该 活动 时 系统 首先 会 在 返回 栈 中 检 
查 是 否 存在 该 活动 的 实例 ， 如 打发 现 已 经 存在 则 直接 使 用 该 实例 ， 并 把 在 
人 活动 统统 出 栈 ， 如 采 没 有 发 现 束 会 创建 一 个 新 的 活动 
实例 。 


我 们 还 是 通过 代码 来 更 加 直观 地 理解 一 下 。 修 改 AndroidManifest.xml 中 
FirstActivity 的 启动 模式 : 


<activity 
android:name=" .FirstActivity" 
android:launchMode="singleTask" 
android:]label="This is FirstActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


然后 在 FirstActivity 中 添加 onRestart() 方法 ， 并 打印 日 志 : 


Q@Override 

protected void onRestart() { 
super .onRestart(); 
Log.d("FirstActivity", "onRestart"); 


后 在 SecondActivity 中 添加 onDestroy() 方法 ， 并 打印 日 志 : 


Q@override 

protected void onDestroy() { 
super .onDestroy(); 
Log.d("SecondActivity", "onDestroy"); 


现在 重新 运行 程序 ， 在 FirstActivity 界 面 点 击 按钮 进入 到 SecondActivity， 然 
后 在 SecondActivity 界 面 点 击 按钮 ， 又 会 重新 进入 到 FirstActivity 。 


查看 logcat 中 的 打印 信息 ， 如 图 2.38 所 示 。 


Debug 四 DrActivity: Regex | Show only 


com. example. activitytest D/FirstActivity: com. example.activitytest.FirstActivity@186799b5 
com. example. activitytest D/SecondActivity: com. example.activitytest. SecondActivity@3c50d14 
com. example. activitytest D/FirstActivity: onRestart 

com. example. activitytest D/SecondActivity: onDestroy 


图 2.38 singleTask 模 式 下 的 打印 日 志 


其 实 从 打印 信息 中 束 可 以 明显 看 出 了 ， 在 SecondActivity 中 局 动 FirstActivity 
时 ， 会 发 现 返回 栈 中 已 经 存在 一 个 FirstActivity 的 实例 ， 并 且 是 在 


SecondActivity 的 下 面 ， 于 是 SecondActivity 会 从 返回 栈 中 出 栈 ， 而 
FirstActivity 重 新 成 为 了 栈 顶 活动 ， 因 此 FirstActivity 的 onRestart () 方法 和 
SecondActivity 的 onpestroy() 方法 会 得 到 执行 。 现 在 返回 栈 中 应 该 只 剩 下 一 
个 FirstActivity 的 实例 了 ， 按 一 下 Back 键 束 可 以 退出 程序 。 


singleTask 模 式 的 原理 示意 图 ， 如 图 2.39 所 示 。 


直接 出 栈 来 重新 回 到 FirstActivity 


启动 SecondActivity 


返回 栈 


图 2.39 singleTask 模 式 示意 图 


2.5.4 _ SingleInstance 


singleInstance 模 式 应 该 算是 4 种 启动 模式 中 最 特殊 也 最 复杂 的 一 个 了 ， 你 也 
需要 多 花 点 功夫 来 理解 这 个 模式 。 不 同 于 以 上 3 种 启动 模式 ， 指 定 为 
singleInstance 模 式 的 活动 会 启用 一 个 新 的 返回 栈 来 管理 这 个 活动 (其实 如 果 
singleTask 模 式 指 定 了 不 同 的 taskAffinity， 也 会 启动 一 个 新 的 返回 栈 ) 。 那 
么 这 样 做 有 什么 意义 呢 ? 想象 以 下 场景 ， 假 设 我 们 的 程序 中 有 一 个 活动 是 
允许 其 他 程序 调用 的 ， 如 果 我 们 想 实现 其 他 程序 和 我 们 的 程序 可 以 共享 这 
个 活动 的 实例 ， 应 该 如 何 实现 呢 ? 使 用 前 面 3 种 启动 模式 肯定 是 做 不 到 的 ， 
因为 每 个 应 用 程序 都 会 有 自己 的 返回 栈 ， 同 一 个 活动 在 不 同 的 返回 栈 中 入 
栈 时 必然 是 创建 了 新 的 实例 。 而 使 用 singleInstance 模 式 就 可 以 解决 这 个 问 


题 ， 在 这 种 模式 下 会 有 一 个 单独 的 返回 栈 来 管理 这 个 活动 ， 不 管 是 哪个 应 
用 程序 来 访问 这 个 活动 ， 都 共用 的 同一 个 返回 栈 ， 也 吏 解 决 了 共 旦 活动 实 
例 的 问题 。 


为 了 帮助 你 更 好 地 理解 这 种 启动 模式 ， 我 们 还 是 来 实践 一 下 。 修 改 
AndroidManifest.xml 中 SecondActivity 的 启动 模式 : 


<activity android:name=".SecondActivity" 
android:launchMode="singleInstance"> 
<intent-filter> 
<action android:name="com.example.activitytest.ACTION_START" /> 
<category android:name="android.intent.category.DEFAULT" /> 


<category android:name="com.example.activitytest.MY_CATEGORY" /> 
</intent-filter> 
</activity> 


我 们 先 将 SecondActivity 的 启动 模式 指定 为 singleInstance， 然 后 修改 
FirstActivity 中 oncreate( ) 方法 的 代码 : 


Q@Override 
protected void onCreate(Bundle savedInstanceState) { 
super .onCreate(savedInstanceState); 
Log.d("FirstActivity", "Task id is " + getTaskId()); 
setcontentView(R.1layout.first_layout); 
Button button1 = (Button) findViewById(R.id.button_1); 
button1.setOonCclickListener(new View.OnClickListener() { 
Q@Override 
public void oncClick(View v) { 
Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
StartActivity(intent ) ， 


在 oncreate() 方法 中 打印 了 当前 返回 栈 的 id。 然 后 修改 SecondActivity 中 
onCreate() 方法 的 代码 : 


Q@Override 
protected void onCreate(Bundle SavedInstanceState) { 
super .onCreate(savedInstanceState); 
Log.d("SecondActivity", "Task id is " + getTaskId()); 
setCcontentView(R.1layout.second_ layout); 
Button button2 = (Button) findViewById(R.id.button 2); 
button2 ,SetOonClickListener(new View.OnClickListener() { 
@override 
public void onClick(View v) { 
Intent intent = new Intent(SecondActivity.this, ThirdActivity.class); 
startActivity(intent); 


}); 


同样 在 oncreate( ) 方法 中 打印 了 当前 返回 栈 的 id ， 然 后 又 修改 了 按钮 点 击 
事件 的 代码 ， 用 于 启动 ThirdActivity。 最 后 修改 ThirdActivity 中 oncreate() 
方法 的 代码 : 


Q@override 

protected void onCreate(Bundle SavedInstanceState) { 
super .onCreate(savedInstanceState); 
Log.d("ThirdActivity", "Task id is " + getTaskId()); 
setcontentView(R.1layout.third_ layout); 


} 


仍然 是 在 oncreate() 方法 中 打印 了 当前 返回 栈 的 id。 现 在 重新 运行 程序 ， 
在 FirstActivity 界 面 点 击 按钮 进入 到 SecondActivity， 然 后 在 SecondActivity 界 
面 点 击 按钮 进入 到 ThirdActivity 。 


查看 logcat 中 的 打印 信息 ， 如 图 2.40 所 示 。 


Debug 图 | Qr Activity: 


com. example. activitytest D/FirstActivity: Task id is 171 
com. example. activitytest D/SecondActivity: Task id is 172 


com. example. activitytest D/ThirdActivity: Task id is 171 


图 2.40 ”singleInstance 模 式 下 的 打印 日 志 


可 以 看 到 ，SecondActivity 的 Task id 不 同 于 FirstActivity 和 ThirdActivity， 这 
说 明 SecondActivity 确 实 是 存放 在 一 个 单独 的 返回 栈 里 的 ， 而 且 这 个 栈 中 只 
有 SecondActivity 这 一 个 活动 。 


然后 我 们 按 下 Back 键 进行 返回 ， 你 会 发 现 ThirdActivity 竟 然 直 接 返 回 到 了 
FirstActivity， 再 按 下 Back 键 又 会 返回 到 SecondActivity， 再 按 下 Back 键 才 会 
退出 程序 ， 这 是 为 什么 呢 ? 其 实 原理 很 简单 ， 由 于 FirstActivity 和 
ThirdActivity 是 存放 在 同一 个 返回 栈 里 的 ， 当 在 ThirdActivity 的 界面 按 下 
Back 键 ，ThirdActivity 会 从 返回 栈 中 出 栈 ， 那 么 FirstActivity 融 成 为 了 栈 顶 活 
动 显 示 在 界面 上 ， 因 此 也 就 出 现 了 从 ThirdActivity 直 接 返回 到 FirstActivity 的 
情况 。 然 后 在 FirstActivity 界 面 再 次 按 下 Back 键 ， 这 时 当前 的 返回 栈 已 经 空 


了 ， 于 是 就 显示 了 男 一 个 返回 栈 的 栈 顶 活动 ， 即 SecondActivity。 最 后 再 次 
按 下 Back 键 ， 这 时 所 有 返回 栈 都 已 经 室 了 ， 也 就 自然 退出 了 程序 。 


singleInstance 模 式 的 原理 示意 图 ， 如 图 2.41 所 示 。 
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图 2.41 singleInstance 模 式 示意 图 


2.6 ”活动 的 最 佳 实践 


你 已 经 掌握 了 关于 活动 非 痹 多 的 知识 ， 不 过 念 怕 离 能 够 完全 灵活 运用 还 有 
一 段 距 离 。 虽 然 知识 点 只 有 这 么 多 ， 但 运用 的 技巧 却 是 多 种 多 样 的 。 所 
以 ， 在 这 里 我 准备 教 你 几 种 关于 活动 的 最 佳 实践 技巧 ， 这 些 技巧 在 你 以 后 
的 开发 工作 当中 将 会 非常 有 用 。 


2.6.1 ”知晓 当前 是 在 哪 一 个 活动 


这 个 技巧 将 教会 你 如 何 根 据 程 序 当 前 的 界面 束 能 判断 出 这 是 哪 一 个 活动 。 
可 能 你 会 觉得 挺 纳 癌 的 ， 我 目 己 写 的 代码 怎么 会 不 知道 这 起 哪 一 个 活动 
呢 ? 很 不 笠 的 是 ， 在 你 真正 进入 到 企业 之 后 ， 更 有 可 能 的 是 接手 一 份 别 人 
写 的 代码 ， 因 为 你 刚 进 公司 就 正好 有 一 个 新 项 目 启 动 的 概率 并 不 高 。 阅 读 
别人 的 代码 时 有 一 个 很 头疼 的 问题 ， 就 是 当 你 需要 在 某 个 界面 上 修改 一 些 
非常 简单 的 东西 时 ， 却 半天 找 不 到 这 个 界面 对 应 的 活动 是 哪 一 个 。 学 会 
本 市 的 技巧 之 后 ， 这 对 你 来 说 束 再 也 不 是 难题 了 。 


我 们 还 是 在 ActivityTest 项 目的 基础 上 修改 ， 首 先 需要 新 建 一 个 BaseActivity 
类 。 石 击 com.example.activitytest 包 一 New 一 Java Class， 在 弹出 的 窗口 出 输 
入 BaseActivity， 如 图 2.42 所 示 。 


两 Create New Class OOO 


1 
Kind: cj Class 圈 


WE [ee 


图 2.42 创建 BaseActivity 类 


注意 这 里 BaseActivity 和 普通 活动 的 创建 方式 并 不 一 样 ， 因 为 我 们 不 需要 
让 BaseActivity 在 AndroidManifest,xml 中 注册 ， 所 以 选择 创建 一 个 普通 的 
Java 类 束 可 以 了 。 然后 让 BaseActivity 继承 自 AppcompatActivity ， 并 重 写 
oncreate() 方法 ， 如 下 所 示 : 


public class BaseActivity extends AppCompatActivity { 


Q@Override 

protected void onCreate(Bundle SavedInstanceState) { 
Super ,onCreate(SavedInstanceState ) ; 
Log.d("BaseActivity", getClass().getSimpleName()); 

} 


} 


我 们 在 oncreate( ) 方法 中 获取 了 当前 实例 的 类 名 ， 并 通过 Log 打 印 了 出 来 。 


接 下 来 我 们 需要 让 BaseActivity 成 为 ActivityTest 项 目 中 所 有 活动 的 父 类 
修改 FirstActivity、SecondActivity 和 ThirdActivity 的 继承 结构 ， 让 它们 不 再 继 
承 自 AppcompatActivity ; 而 是 继承 自 BaseActivity © 而 由 于 BaseActivity 
又 是 继承 自 AppCcompatActivity 的 ， 所 以 项 目 中 所 有 活动 的 现 有 功能 并 不 受 
影响 ， 它 们 仍然 完全 继承 了 Activity 中 的 所 有 特性 


现在 重新 运行 程序 ， 然 后 通过 点 击 按钮 分 别 进入 到 FirstActivity、 
SecondActivity 和 es 界面 ， 这 时 观察 logcat 中 的 打印 信息 ， 如 图 
2.43 所 示 。 
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com. example. activitytest D/BaseActivity: FirstActivity 


com. example. activitytest D/BaseActivity: SecondActivity 
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图 2.43 BaseActivity 中 的 打印 日 志 


现在 每 当 我 们 进入 到 一 个 活动 的 界面 ， 该 活动 的 类 名 束 会 补 打 印 出 来 ， 这 
样 我 们 束 可 以 时 时 刻 刻 知晓 当前 界面 对 应 的 是 哪 一 个 活动 了 。 


2.6.2 ”随时 随地 退出 程序 


如 果 目 前 你 手机 的 界面 还 停留 在 ThirdActivity， 你 会 发 现 当 前 想 退 出 程序 是 
非常 不 方便 的 ， 需 要 连 按 3 次 Back 键 才 行 。 按 Home 键 只 是 把 程序 挂 起 ， 并 
没有 退出 程序 。 其 实 这 个 问题 就 足以 引起 你 的 思考 ， 如 果 我 们 的 程序 需要 
一 个 注销 或 者 退出 的 功能 该 怎么 办 呢 ? 必须 要 有 一 个 随时 随地 都 能 退出 程 
序 的 方案 才 行 。 


其 实 解决 思路 也 很 简单 ， 只 需要 用 一 个 专门 的 集合 类 对 所 有 的 活动 进行 管 
理 就 可 以 了 ， 下 面 我 们 就 来 实现 一 下 。 


新 建 一 个 Activitycollector 类 作为 活动 管理 器 ， 代 码 如 下 所 示 : 


public class ActivityCollector { 
public static List<Activity> activities = new ArrayList<>(); 
public static void addActivity(Activity activity) { 


activities.add(activity); 


public static void removeActivity(Activity activity) { 
activities.remove(activity); 


public static void finishAll() { 


for (Activity activity : activities) { 
if (!activity.isFinishing()) { 
activity.finish(); 


} 


activities.clear(); 


} 


在 活动 管理 絮 中 ， 我 们 通过 一 个 List 来 和 暂 存 活动 ， 然 全 
addActivity() 方法 用 于 癌 List 中 添加 一 个 活动 ， 

removeActivity( ) 方法 用 于 从 List 中 移 除 活动 ， 0 ee 
方法 用 于 将 List 中 存储 的 活动 全 部 销毁 掉 。 


接 下 来 修改 easeActivity 中 的 代码 ， 如 下 所 示 : 


public class BaseActivity extends AppCompatActivity { 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d("BaseActivity", getClass().getSsimpleName()); 
ActivityCollector.addActivity(this); 

} 


Q@Override 

protected void onDestroy() { 
super .onDestroy(); 
ActivityCollector.removeActivity(this); 


} 


在 BaseActivity 的 oncreate() 方法 中 调用 TActivityCollector 的 
addActivity() 方法 ， 表 明 将 当前 正在 创建 的 活动 添加 到 活动 管理 器 里 。 然 
后 在 BaseActivity 中 重 写 onDestroy() 方法 ， 并 调用 Tetiviyeoneetor 
的 removeActivity() 方法 ， 表 明 将 一 个 马上 要 销毁 的 活动 从 活动 管理 恬 

移 除 。 


从 此 以 后 ， 不 管 你 想 在 什么 地 方 退出 程序 ， 只 需要 调用 
Aorivitycollector finishAl1() 方法 就 可 以 了 。 例如 在 ThirdActivity 界 面 想 
通过 点 击 按钮 直接 退出 程序 ， 只 需 将 代码 改 成 如 下 所 示 : 


public class ThirdActivity extends BaseActivity { 


QOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d("ThirdActivity", "Task id is " + getTaskId()); 
setcontentView(R.1layout.third_layout); 
Button button3 = (Button) findViewById(R.id.button_ 3); 
button3 ,setonCclickListener(new View.OnClickListener() { 
Q@Override 
public void onClick(View v) { 
ActivityCollector .finishAll(); 
} 


1)3 


| 
当然 你 还 可 以 在 销毁 所 有 活动 的 代码 后 面 再 加 上 杀 掉 当前 进程 的 代码 ， 以 
保证 程序 完全 退出 ， 儿 挥 进程 的 代码 如 下 所 示 : 


android.os.Process.killProcess(android.os.Process.myPid( )); 


其 中 ，killProcess() 方法 用 于 攻 挥 一 个 进程 ， 它 接收 一 个 进程 i 参数， 我 
们 可 以 通过 mypPid() 方法 来 获得 当前 程序 的 进程 jd 。 需 要 注意 的 是 ， 
killProcess() 方法 只 能 用 于 杀 挥 当前 程序 的 进程 ， 我 们 不 能 使 用 这 个 方法 
去 杀 掉 其 他 程序 。 


2.6.3 ”局 动 活 动 的 最 佳 写法 


启动 活动 的 方法 相信 你 已 经 非常 熟悉 了 ， 首 先 通过 Intent 构 建 出 当前 的 “ 意 
图 ”， 然 后 调用 startActivity() 或 startActivityForResult() 方法 将 活动 局 
动 起 来 ， 如 果 有 数据 需要 从 一 个 活动 传递 到 另 一 个 活动 ， 也 可 以 借助 Intent 


假设 SecondActivity 中 需要 用 到 两 个 非常 重要 的 字符 串 参 数 ， 在 启动 
SecondActivity 的 时 候 必 须要 传递 过 来 ， 那 么 我 们 很 容易 会 写 出 如 下 代码 : 


Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
intent.putExtra("param1i", "data1"); 
intent.putExtra("param2", "data2"); 


startActivity(intent); 


这 样 写 是 完全 正确 的 ， 不 管 是 从 语法 上 还 是 规范 上 ， 只 是 在 真正 的 项 目 开 
发 中 经 常会 有 对 接 的 问题 出 现 。 比 如 SecondActivity 并 不 是 由 你 开发 的 ， 但 
现在 你 负责 的 部 分 需要 有 启动 SecondActivity 这 个 功能 ， 而 你 却 不 清楚 启动 
这 个 活动 需要 传递 哪些 数据 。 这 时 无 非 就 有 两 种 办 法 ， 一 个 是 你 自己 去 阅 
读 secondActivity 中 的 代码 ， 二 是 询问 负责 编写 SecondActivity 的 同事 。 你 会 
不 会 觉得 很 麻烦 呢 ? 其 实 只 需要 换 一 种 写法 ， 就 可 以 轻松 解决 掉 上 面 的 窒 


境 。 


修改 SecondActivity 中 的 代码 ， 如 下 所 示 : 


public class SecondActivity extends BaseActivity { 


public static void actionStart(Context context, String datai, String data2) { 
Intent intent = new Intent(context, SecondActivity.class); 
intent.putExtra("param1i", data1); 
intent.putExtra("param2", data2); 
context.startActivity(intent); 


我 们 在 SecondActivity 中 添加 了 一 个 actionstart() 方法 ， 在 这 个 方法 中 完成 
了 Intent 的 构建 ， 另 外 所 有 SecondActivity 中 需要 的 数据 都 是 通过 
actionstart() 方法 的 参数 传递 过 来 的 ， 然 后 把 它们 存储 到 Intent 中 ， 最 后 调 
用 startActivity() 方法 启动 SecondActivity 。 


这 样 写 的 好 处 在 哪里 呢 ? 最 重要 的 一 点 就 是 一 日 了 7 然 ，SecondActivity 所 需 
要 的 数据 在 方法 参数 中 全 部 体现 出 来 了 ， 这 样 即使 不 用 阅读 SecondActivity 
中 的 代码 ， 不 去 询问 负责 编写 SecondActivity 的 同事 ， 你 也 可 以 非常 清晰 地 
知道 启动 SecondActivity 需 要 传递 哪些 数据 。 男 外 ， 这 样 写 还 简化 了 启动 活 
动 的 代码 ， 现 在 只 需要 一 行 代码 就 可 以 启动 SecondActivity， 如 下 所 示 : 


button1.SsetonCclickListener(new OnClickListener() { 
QOverride 
public void onClick(View v) { 
SecondActivity.actionSstart(FirstActivity.this, "datai", "data2"); 


养 成 一 个 良好 的 习惯 ， 给 你 编写 的 每 个 活动 都 添加 类 似 的 启动 方法 ， 这 样 


人 还 可 以 节省 不 少 你 同事 过 来 询问 你 的 
时 间 。 


2.7 “小 绪 与 点 评 


真是 好 疲惫 啊 ! 没 错 ， 学 习 了 这 么 多 的 东西 不 疲惫 才 怪 呢 。 但 是 ， 你 内 心 
那 种 掌握 了 知识 的 喜悦 感 相 信也 是 无 法 撼 次 的 。 本 章 的 收获 非 营 多 啊 ， 不 
管 是 理论 型 还 是 实践 型 的 东西 都 涉及 了 ， 从 活动 的 基本 用 法 ， 到 局 动 活动 


和 传递 数据 的 方式 ， 再 到 活动 的 生命 周期 ， 以 及 活动 的 局 动 模式 ， 你 几乎 
已 经 学 会 了 关于 活动 所 有 重要 的 知识 点 。 男 外 在 本 章 的 最 后 ， 还 学 习 了 几 
种 可 以 应 用 在 活动 中 的 最 佳 实践 搁 巧 ， 达 不 舍 张 地 说 ， 你 在 Android 活 动 方 
面 已 经 算是 一 个 小 高 手 了 。 


不 过 你 的 Android 旅 途 才 刚刚 开始 呢 ， 后 面 需要 学 习 的 东西 还 很 多 ， 也 许 会 
比 现在 还 累 ， 一 定 要 做 好 心理 准备 哦 。 总 体 来 说 ， 我 给 你 现在 的 状态 打 江 
分 ， 毕 竞 你 已 经 学 会 了 那 和 多 的 东西 ， 也 是 时 候 放 松 一 下 了 。 自 己 适 当 控 
制 一 下 休息 的 时 间 ， 然 后 我 们 继续 前 进 吧 


第 3 章 ”软件 也 要 拼 脸蛋 一 一 UI 开发 
的 扩 扩 滴 滴 


我 一 直 部 认为 程序 员 在 软件 的 审美 方面 普 裔 都 比较 差 ， 至 少 我 个 人 就 古 如 
此 。 如 果 说 要 追究 其 根本 原因 ， 我 觉得 这 是 由 程序 员 的 工作 性 质 所 导致 
的 。 每 当 我 们 看 到 一 个 软件 时 ， 不 会 像 普 通用 户 那 样 仅仅 是 关注 一 下 它 的 
界面 和 功能 ， 而 是 会 不 目 觉 地 思考 这 些 功 能 是 如 何 实现 的 。 很 多 在 普通 用 
户 看 来 理 所 应 当 的 功能 ， 背 后 可 能 却 需 要 非常 复杂 的 逻辑 来 完成 ， 以 至 于 
9 
得 好 牛 啊 ”! 


不 过 缺乏 审美 观 毕竟 不 是 一 件 值得 炫 潜 的 事情 ， 在 软件 开发 过 程 中 ， 界 面 
设计 和 功能 开发 同样 重要 。 界 面 美观 的 应 用 程序 不 仅 可 以 大 大 增加 用 户 炸 
性 ， 还 能 帮 我 们 吸引 到 更 多 的 新 用 户 。 而 Android 也 给 我 们 提供 了 大 量 的 UI 
开发 工具 ， 只 要 合理 地 使 用 它们 ， 就 可 以 编写 出 各 种 各 样 漂亮 的 界面 。 


在 这 里 ， 我 无 法 教会 你 如 何 提升 自己 的 审美 观 ， 但 我 可 以 教会 你 怎样 使 用 
Android 提 供 的 UI 开 发 工具 来 编写 程序 界面 。 你 在 上 一 章 中 反 反 复 复 地 使 用 
站 
H 识 。 


3.1 ”如 何 编写 程序 界面 


Android 中 有 多 种 编写 程序 界面 的 方式 可 供 选 择 。Android Studio 和 Eclipse 中 
部 提供 了 相应 的 可 视 化 编辑 器 级， 人 允许 使 用 拖 放 控件 的 方式 来 编写 布局 ， 并 

能 在 视图 上 直接 修改 控件 的 属 性 。 不 过 我 并 不 推荐 你 使 用 这 种 方式 来 编写 
界面 因为 可 视 化 编辑 工具 并 不 利于 你 去 真正 了 解 界面 背后 的 实现 原理 。 
通过 这 种 方式 制作 出 的 界面 通常 不 具有 很 好 的 屏幕 适 配 性 ， 而 且 当 需要 编 
写 较为 复杂 的 界面 时 ， 可 视 化 编辑 工具 将 很 难 胜任 。 因 此 本 书 中 所 有 的 界 
面 都 将 通过 最 基本 的 方式 去 实现 ， 即 编写 XML 代 码 。 A 
XML 来 编写 界面 的 方法 之 后 ， 不 管 是 进行 高 复杂 度 的 界面 实现 ， 还 是 分 析 
和 修改 当前 现 有 界面 ， 对 你 来 说 都 将 是 手 到 擒 来 。 


讲 了 这 人 么 多 理论 的 东西 ， 也 是 时 候 学习 一 下 到 展 如 何 编写 程序 界面 了 ， 下 
面 我 们 束 从 Android 中 几 种 常见 的 控件 开始 吧 。 


3.2 ”常用 控件 的 使 用 方法 


Android 提 供 了 大 量 的 UI 控件 ， 合 理 地 使 用 这 些 控件 整 可 以 非 第 轻松 地 编写 
0 下 面 我 们 束 挑 选 几 种 党 用 的 控件 ， 详 细 介 绍 一 下 它们 
9 使 用 方法 。 


首先 狐 建 一 个 UIWidgetTest 项 目 ， 简 单 起 见 ， 我 们 还 是 允许 Android Studio 自 
动 创 建 活 动 ， 活 动 名 和 布局 名 都 使 用 默认 值 。 


3.2.1 TextView 

TextView 可 以 说 是 Android 中 最 简单 的 一 个 控件 了 ， 你 在 前 面 其 实 已 经 和 它 
打 过 一 些 交 道 了 。 它 主要 用 于 在 界面 上 显示 一 段 文本 信息 ， 比 如 你 在 第 1 章 
看 到 的 “Hello world! ”。 下 面 我 们 就 来 看 一 看 关于 TextView 的 更 多 用 法 。 


修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:id="@+id/text_view" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="This is TextView" /> 


</LinearLayout> 


| | 


外 面 的 LinearLayout 先 忽略 不 看 ， 在 TextView 中 我 们 使 用 android:id 给 当前 
控件 定义 了 一 个 唯一 标识 待 ， 这 个 属性 在 上 一 章 中 已 经 讲解 过 了 “。 然 后 使 
用 android:1layout_width android:1layout_height 指定 了 控件 的 宽度 和 高 
度 。Android 中 所 有 的 控件 都 具有 这 两 个 属性 ， 可 选 值 有 3 种 : match_parent 
~ fill parent 和 wrap_content 9 其 中 match_parent 和 fil1_parent 的 意义 
相同 ， 现在 官方 更 加 推荐 使 用 match_parent ° match_parent 表示 让 当前 控 
件 的 大 小 和 父 布局 的 大 小 一 样 ， 也 就 是 由 父 布 局 来 决定 当前 控件 的 大 小 。 
wrap_content 表示 让 当前 控件 的 大 小 能 够 刚好 包含 住 里 面 的 内 容 ， 也 就 是 
由 控件 内 容 决 定 当前 控件 的 大 小 。 所 以 上 面 的 代码 就 表示 让 TextView 的 宽度 
和 父 布局 一 样 宽 ， 也 避 是 手机 屏幕 的 宽度 ， 让 TextView 的 高 度 足够 包含 住 里 
面 的 内 容 惑 行 。 当 然 除了 使 用 上 述 值 ， 你 也 可 以 对 控件 的 宽 和 高 指定 一 个 
固定 的 大 小 ， 但 是 这 样 做 有 时 会 在 不 同 手机 屏幕 的 适 配 方面 出 现 问题 。 


接 下 来 我 们 通过 android:text 指定 TextView 中 显示 的 文本 内 容 ， 现 在 运行 程 
序 ， 效 果 如 图 3.1 所 示 。 
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图 3.1 TextView 运 行 效果 


虽然 指定 的 文本 内 容 正 常 显示 了 ， 不 过 我 们 好 像 没 看 出 来 TextView 的 宽度 是 
和 屏幕 一 样 宽 的 。 其 实 这 是 由 于 TextView 中 的 文字 默认 是 届 左 上 角 对 齐 的 ， 
虽然 TextView 的 宽 度 充满 了 整个 屏幕 ， 可 是 由 于 文字 内 容 不 够 长 ， 所 以 从 效 
果 上 完全 看 不 出 来 。 现 在 我 们 修改 TextView 的 文字 对 齐 方式 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:id="@+id/text_view" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 


android:gravity="center" 
android:text="This is TextView" /> 


</LinearLayout> 


我 们 使 用 android: gravity > 来 指定 文字 的 对 齐 方 式 ， 可 选 值 有 top 、bottom 
、left 、right 、center 等 ， 可 以 用 “" 来 同时 指定 多 个 值 ， 这 里 我 们 指定 
的 center 效果 等 同 于 center_vertical|center_horizontal ， 表示 文字 在 


垂直 和 水 平方 同 都 居中 对 齐 。 现 在 重新 运行 程序 ， 效 果 如 图 3.2 所 示 。 


UIWidgetTest 


图 3.2 TextView 居 中 效果 
这 也 说 明了 TextView 的 宽度 确实 是 和 屏幕 宽度 一 样 的 。 
另外 我 们 还 可 以 对 TextView 中 文字 的 大 小 和 颜色 进行 修改 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:id="@+id/text_view" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:gravity="center" 
android:textSize="24sp" 
android:textColor="#00ff0O0" 
android:text="This is TextView" /> 


</LinearLayout> 


通过 android:textsize 属性 可 以 指定 文字 的 大 小 ， 通 过 android:textcolor 
属性 可 以 指定 文字 的 颜色 ， 在 Android 中 字体 大 小 使 用 sp 作为 单位 。 重 新 运 
行程 序 ， 效 果 如 图 3.3 所 示 。 
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This is TextView 


图 3.3 ”改变 TextView 文 字 大 小 和 颜色 的 效果 


当然 TextView 中 还 有 很 多 其 他 的 属性 ， 这 里 吏 不 再 一 一 介绍 了 ， 用 到 的 时 候 
去 查阅 文档 束 可 以 了 。 


3.2.2 Button 


Button 是 程序 用 于 和 用 户 进行 交互 的 一 个 重要 控件 ， 相 信 你 对 这 个 控件 已 经 
非常 熟悉 了 ， 因 为 我 们 在 上 一 章 用 了 太 多 次 Button。 它 可 配置 的 属性 和 
TextView 是 差不多 的 ， 我 们 可 以 在 activity_main.xml 中 这 样 加 入 Button: 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/button" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Button" /> 


</LinearLayout> 


加 入 Button 之 后 的 界面 如 图 3.4 所 示 。 
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This is TextView 


BUTTON 


图 3.4 Button 运 行 效果 


细心 的 你 可 能 会 留意 到 ， 我 们 在 布局 文件 里 面 设置 的 文字 是 “Button”*， 但 最 
终 的 显示 结果 却 是 “BUTTON”。 这 是 由 于 系统 会 对 Button 中 的 所 有 英文 字母 
自动 进行 大 写 转换 ， 如 果 这 不 是 你 想 要 的 效果 ， 可 以 使 用 如 下 配置 来 禁 

这 一 默认 特性 : 


<Button 
android:id="@+id/button" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Button" 


android:textAllcaps="false" /> 


接 下 来 我 们 可 以 在 MainActivity 中 为 Button 的 点 击 事件 注册 一 个 监听 器 ， 如 
下 所 示 : 


public class MainActivity extends AppCompatActivity { 


Q@Override 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
Button button = (Button) findViewById(R.id.button); 
button.setOonClickListener(new View.OnClickListener() { 
Q@Override 
public void oncClick(View v) { 


// 在 此 处 添加 逻辑 


} 
}); 


这 样 每 当 点 击 按钮 时 ， 就 会 执行 监听 器 中 的 onclick() 方法 ， 我 们 只 需要 在 
这 个 方法 中 加 入 待 处 理 的 逻辑 束 行 了 。 如 有 果 你 不 喜欢 使 用 匿名 类 的 方式 来 
主 册 监听 器 ， 也 可 以 使 用 实现 接口 的 方式 来 进行 注册 ， 代 码 如 下 所 示 : 
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一 < 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
Button button = (Button) findViewById(R.id.button); 
button.setOoncClickListener(this); 

上 


QOverride 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
// 在 此 处 添加 逻辑 
break; 
default: 
break; 


| 


这 丙种 写法 部 可 以 实现 对 按 乌 点击 事件 的 鉴 听 ， 至 于 使用 一 种 就 全 途 人 
9 喜好 了 。 


3.2.3 EditText 


EditText 是 程序 用 于 和 用 户 进行 交互 的 男 一 个 重要 控件 ， 它 允许 用 户 在 控件 
里 输入 和 编辑 内 容 ， 并 可 以 在 程序 中 对 这 些 内 容 进行 处 理 。EditText 的 应 用 
场景 非常 普 裔 ， 在 进行 发 短信 、 发 微 博 、 聊 QQ 等 操作 时 ， 你 不 得 不 使 用 
EditText。 那 我 们 来 看 一 看 如 何在 界面 上 加 入 EditText 吧 ， 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<EditText 
android:id="@+id/edit_ text" 


android:layout_width="match_parent" 


android:layout_height="wrap_content" 
/> 


</LinearLayout> 


其 实 看 到 这 里 ， 我 估计 你 已 经 总 结 出 Android 探 件 的 使 用 规律 了 ， 用 法 基本 
上 都 很 相似 : 给 控件 定义 一 个 id， 再 指定 控件 的 宽度 和 高 度 ， 然 后 再 适当 加 
入 一 些 控件 符 有 的 属性 束 差 不 多 了 。 


所 以 使 用 XML 来 编写 界面 其 实 一 点 都 不 难 ， 完 全 可 以 不 用 借助 任何 可 视 化 
工具 来 实现 。 现 在 重新 运行 一 下 程序 ，EditText 距 已 经 在 界面 上 显示 出 来 
了 ， 并 且 我 们 是 可 以 在 里 面 输入 内 容 的 ， 如 图 3.5 所 示 。 
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图 3.5 EditText 运 行 效果 


细心 的 你 平时 应 该 会 留意 到 ， 一 些 做 得 比较 人 性 化 的 软件 会 在 输入 框 里 显 
示 一 些 提 示 性 的 文字 ， 然后 一 旦 用 户 输入 了 任何 内 容 ， 这 些 提示 性 的 文字 
就 会 消失 。 这 种 提示 功能 在 Android 里 是 非常 容易 实现 的 ， 我 们 甚至 不 需 
做 任何 的 逻辑 控制 ， 因 为 系统 已 经 帮 我 们 都 处 理 好 了 。 修 改 
activity_main.xml， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<EditText 
android:id="@+id/edit_ text" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:hint="Type something here" 
/> 


</LinearLayout> 


| | 


这 里 使 用 android:hint 属性 指定 了 一 段 提 示 性 的 文本 ， 人 然后 重新 运行 程 
序 ， 效 果 如 图 3.6 所 示 。 
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图 3.6 EditText 设 置 hint 效 果 


可 以 看 到 ，EditText 中 显示 了 一 段 提 示 性 文本 ， 然 后 当 我 们 输入 任何 内 容 
时 ， 这 段 文本 束 会 目 动 消 失 。 


不 过 ， 随 着 输入 的 内 容 不 断 增 多 ，EditText 会 被 不 断 地 拉 长 。 这 时 由 于 
EditText 的 高 度 指定 的 是 wrap_content ， 因 此 它 总 能 包含 住 里 面 的 内 容 ， 但 
是 当 输 入 的 内 容 过 多 时 ， 界 面 就 会 变 得 非常 难看 。 我 们 可 以 使 用 
android:maxLines 属性 来 解决 这 个 问题 ， 修 改 activity_main.xml， 如 下 所 


仆 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 


android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<EditText 
android:id="@+id/edit_ text" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:hint="Type something here" 
android:maxLines="2" 
/> 


</LinearLayout> 


这 里 通过 android:maxLines 指定 了 EditText 的 最 大 行 数 为 两 行 ， 这 样 当 输入 
的 内 容 超 过 两 行 时 ， 文 本 就 会 向 上 滚动 ， 而 EditText 则 不 会 再 继续 拉 伸 ， 如 
图 3.7 所 示 。 
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图 3.7 EditText 设 置 maxLines 效 果 


我 们 还 可 以 结合 使 用 EditText 与 Button 来 完成 一 些 功能 ， 比 如 通过 点 击 按钮 
来 获取 EditText 中 输入 的 内 容 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 
private EditText editText; 


Q@Override 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedIinstanceState); 
setcontentView(R.1layout.activity_main); 
Button button = (Button) findViewById(R.id.button); 
editText = (EditText) findViewById(R.id.edit text); 
button.setonclickListener(this); 


Q@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
String inputText = editText.getText().toString(); 
Toast.makeText (MainActivity.this, inputText, 
Toast .LENGTH_SHORT) .show( )， 
break ， 
default: 
break; 


首先 通过 findviewById() 方法 得 到 EditText 的 实例 ， 然 后 在 按钮 的 点 击 事件 
里 调用 EditText 的 getText () 方法 获取 到 输入 的 内 容 ， 再 调用 tostring() 方 
法 转换 成 字符 串 ， 最 后 还 是 老 方法 ， 使 用 Toast 将 输入 的 内 容 显 示 出 来 。 


重新 运行 程序 ， 在 EditText 中 输入 一 段 内 容 ， 然 后 点 击 按钮 ， 效 末 如 图 3.8 所 
太 ° 
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图 3.8 ”获取 EditText 中 输入 的 内 容 


3.2.4 ImageView 


ImageView 是 用 于 在 界面 上 展示 图 片 的 一 个 控件 ， 它 可 以 让 我 们 的 程序 界面 
变 得 更 加 丰富 多 彩 。 学 习 这 个 控件 需要 提前 准备 好 一 些 图 片 ， 图 片 通常 都 
是 放 在 以 “drawable” 开 头 的 目录 下 的 。 目 前 我 们 的 项 目 中 有 一 个 空 的 
drawable 目 录 ， 不 过 由 于 这 个 目录 没有 指定 具体 的 分 辨 紊 ， 所 以 一 般 不 使 用 
它 来 放置 图 片 。 这 里 我 们 在 res 目 录 下 新 建 一 个 drawable-xhdpi 上 有 目录， 然后 将 
事先 准备 好 的 两 张 图 片 img_1.png 和 img_2.png 复 制 到 该 目 台 当中 。 


接 下 来 修改 activity_main.xml， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<ImageView 
android:id="@+id/image_view" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:src="@drawable/img 1 " 
/> 


</LinearLayout> 


可 以 看 到 ， 这 里 使 用 android:src 属性 给 ImageView 指 定 了 一 张 图 片 。 由 于 
图 乒 的 宽 和 高 都 是 未 知 的 ， 所 以 将 ImageView 的 宽 和 高 都 设 定 为 
wrap_content ， 这 样 就 保证 了 不 管 图 片 的 尺寸 是 多 少 ， 图 片 都 可 以 完整 地 
展示 出 来 。 重 新 运行 程序 ， 歼 果 如 图 3.9 所 示 。 


UlWidgetTest 


This is TextView 


BUTTON 


图 3.9 ”ImageView 运 行 效果 


我 们 还 可 以 在 程序 中 通过 代码 动态 地 更 改 ImageView 中 的 图 片 ， 然 后 修改 
MainActivity 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private EditText editText; 
private ImageView imageView; 


QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedIinstanceState); 
setcontentView(R.1layout.activity_main); 
Button button = (Button) findViewById(R.id.button); 
editText = (EditText) findViewById(R.id.edit text); 
imageView = (ImageView) findViewById(R.id.image view); 
button.setoncClickListener(this); 

} 


QOverride 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
imageView,.setIimageResource(R.drawable.img_ 2); 
break; 
default: 
break; 


在 按钮 的 点 击 事件 里 ， 通 过 调用 ImageView 的 setImageResource() 方法 将 显 
示 的 图 片 改 成 img_ 2， 现在 重新 运行 程序 ， 然 后 点 击 一 下 按钮 ， 就 可 以 看 到 
ImageView 中 显示 的 图 片 改 变 了 ， 如 图 3.10 所 示 。 
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图 3.10 动态 更 改 ImageView 中 的 图 片 


3.2.5 ProgressBar 


ProgressBar 用 于 在 界面 上 显示 一 个 进度 条 ， 表 示 我 们 的 程序 正在 加 载 一 些 
数据 。 它 的 用 法 也 非常 简单 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<ProgressBar 
android:id="@+id/progress_bar" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
/> 


</LinearLayout> 


重新 运行 程序 ， 会 看 到 屏幕 中 有 一 个 圆 形 进度 条 正在 旋转 ， 如 图 3.11 所 示 。 
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图 3.11 ProgressBar 运 行 效果 


这 时 你 可 能 会 问 ， 旋 转 的 进度 条 表明 我 们 的 程序 正在 加 载 数据 ， 那 数据 总 
会 有 加 载 完 的 时 候 吧 ? 如 何 才 能 让 进度 条 在 数据 加 载 完成 时 消失 呢 ? 这 里 
我 们 就 需要 用 到 一 个 新 的 知识 点 : Android 控 件 的 可 见 属 性 。 所 有 的 Android 
控件 都 具有 这 个 属性 ， 可 以 通过 android:visibility 进行 指定 ， 可 选 值 有 3 
种 : visible 、invisible 和 gone。visible 表示 控件 是 可 见 的 ， 这 个 值 是 
默认 值 ， 不 指定 android:visibility 时 ， 控 件 都 是 可 见 的 。invisible 表示 
控件 不 可 见 ， 但 是 它 仍然 占据 着 原来 的 位 置 和 大 小 ， 可 以 理解 成 控件 变 成 
透明 状态 了 。gone 则 表示 控件 不 仅 不 可 见 ， 而 且 不 再 占用 任何 屏幕 空间 。 
我 们 还 可 以 通过 代码 来 设置 控件 的 可 见 性 ， 使 用 的 是 setvisibility() 方 


法 ， 可 以 传 入 view.VISIBLE 、View,INVISIBLE 和 View.GONE 这 3 种 值 。 


接 下 来 我 们 束 来 答 试 实现 ， 点 击 一 下 按钮 让 进度 条 消失 ， 再 点 击 一 下 按钮 
让 进度 条 出 现 的 这 种 效果 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private EditText editText; 
private ImageView imageView; 
private ProgressBar progressBar; 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
Super .onCreate(SavedInstanceState ) 
setcontentView(R.1layout.activity_main); 
Button button = (Button) findViewById(R.id.button); 
editText = (EditText) findViewById(R.id.edit text); 
imageView = (ImageView) findViewById(R.id.image_ view); 
progressBar = (ProgressBar) findViewById(R.id.progress_ bar); 
button.setonclickListener(this); 

} 


QOverride 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
If (progressBar.getVisibility() == View.GONE) { 
progressBar.setVisibility(View.VISIBLE); 
} else { 
progressBar.setVisibility(View.GONE); 
} 


break; 
default: 
break; 


在 按钮 的 点 击 事件 中 ， 我 们 通过 getvisibility() 方法 来 判断 ProgressBar 是 
否 可 见 ， 如 果 可 见 就 隐藏 掉 ， 如 果 不 可 见 就 将 ProgressBar 显 示 
出 来 。 重 新 运行 程序 ， 然 后 不 断 地 点 击 按钮 ， 你 就 会 看 到 进度 条 会 在 显示 
与 隐藏 之 间 来 回 切换 。 


另外 ， 我 们 还 可 以 给 ProgressBar 指 定 不 同 的 样式 ， 刚 刚 是 圆 形 进度 条 ， 通 
过 style 属性 可 以 将 它 指定 成 水 平 进度 条 ， EC i mai ee 
码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 


android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<ProgressBar 
android:id="@+id/progress_bar" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
style="?android:attr/progressBarStyleHorizontal" 
android:max="100" 
/> 


</LinearLayout> 


指定 成 水 平 进 度 条 我 们 还 可 以 通过 android:max 属性 给 进度 条 设置 一 个 
最 大 值 ， 然 后 在 井 度 条 的 进度 。 修 改 MainActivity 中 的 代 


码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


Q@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
int progress = progressBar.getProgress(); 
progress = progress + 10; 
progressBar.setprogress(progress); 
break; 
default: 
break; 


每 点 击 一 次 按钮 ， 我 们 就 获取 进度 条 的 当前 进度 ， 然 后 在 现 有 的 进度 上 加 
10 作 为 更 新 后 的 进度 。 重 新 运行 程序 ， 0 效果 如 图 3.12 所 
示 o 
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图 3.12 ProgressBar 水 平 样式 效果 
ProgressBar 还 有 几 种 其 他 的 样式 ， 你 可 以 目 己 去 壬 斌 一下。 


3.2.6 AlertDialog 


AlertDialog 可 以 在 当前 的 界面 弹出 一 个 对 话 框 ， 这 个 对 话 框 是 置顶 于 所 有 界 
面 元 素 之 上 的 ， 能 够 屏蔽 掉 其 他 控件 的 交互 能 力 ， 因 此 AlertDialog 一 般 都 是 
用 于 提示 一 些 非常 重要 的 内 容 或 者 警告 信息 。 比 如 为 了 防止 用 户 误 删 重要 
内 容 ， 在 删除 前 弹出 一 个 确认 对 话 框 。 下 面 我 们 来 学 习 一 下 它 的 用 法 ， 修 
改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


QOverride 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 


AlertDialog.Builder dialog = new AlertDialog.Builder (MainActivity. 
this); 
dialog.setTitle("This is Dialog"); 
dialog.setMessage("Something important."); 
dialog.setCcancelable(false); 
dialog.setPositiveButton("OK", new DialogInterface ， 
OnclickListener() { 
Q@Override 
public void oncClick(DialogInterface dialog, int which) { 
} 
}); 
dialog.setNegativeButton("Cancel", new DialogInterface. 
OnClickListener() { 
Q@Override 


public void oncClick(DialogInterface dialog, int which) { 
} 


}); 

dialog.show(); 

break; 
default: 

break; 


首先 通过 AlertDialog.Builder 创 建 一 个 AlertDialog 的 实例 ， 然 后 可 以 为 这 个 对 


话 框 设置 标题 、 内 容 、 可 否 用 Back 键 关闭 对 话 框 等 属性 ， 接 下 来 调用 
setpPositiveButton() 方法 为 对 话 框 设置 确定 按钮 的 点 击 事件 ， 调 用 
setNegativeButton( ) 方法 设置 取消 按钮 的 点 击 事件 ， 最 后 调用 show( ) 方法 
将 对 话 框 显 示 出 来 。 重 新 运行 程序 ， 点 击 按钮 后 ， 效 果 如 图 3.13 所 示 。 
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图 3.13 ”AlertDialog 运 行 效果 


3.2.7 ProgressDialog 


ProgressDialog 和 AlertDialog 有 点 类 似 ， 都 可 以 在 界面 上 弹出 一 个 对 话 框 ， 

都 能 够 屏蔽 抒 其 他 控件 的 交互 能 力 。 不 同 的 是 ，ProgressDialog 会 在 对 话 框 
中 显示 一 个 进度 条 ， 一 般 用 于 表示 当前 操作 比较 耗 时 ， 让 用 户 耐心 地 等 

待 。 它 的 用 法 和 AlertDialog 也 比较 相似 ， 修 改 MainActivity 中 的 代码 ， 如 下 
所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


Q@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
ProgressDialog progressDialog = new ProgressDialog 
(MainActivity.this); 
progressDialog.setTitle("This is ProgressDialog"); 


progressDialog.setMessage("Loading..."); 
progressDialog.setCancelable(true); 
progressDialog.show(); 
break; 

default: 
break; 


可 以 看 到 ， 这 里 也 是 先 构 建 出 一 个 progressDialog 对 象 ， 然 后 同样 可 以 设 
置 标题 、 内 容 、 可 否 取 消 等 属性 ， 最 后 也 是 通过 调用 show( ) 方法 将 
ProgressDialog 显 示 出 来 重新 运行 程序 ， 点 击 按钮 后 ， 效 末 如 图 3.14 所 
示 o 
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图 3.14 ProgressDialog 运 行 效果 


注意 ， 如 果 在 setcancelable() 中 传 入 了 false ， 表 示 ProgressDialog 是 不 能 
通过 Back 键 取消 挥 的 ， 这 时 你 就 一 定 要 在 代码 中 做 好 控制 ， 当 数据 加 载 完 
成 后 必须 要 调用 ProgressDialog 的 dismiss() 方法 来 关闭 对 话 框 ， 否 则 
ProgressDialog 将 会 一 直 存 在 。 


好 了 ， 关 于 Android 和 常用 控件 的 使 用 ， 我 要 讲 的 就 只 有 这 么 多 。 一 节 内 容 就 
想 覆 盖 Android 控 件 所 有 的 相关 知识 不 太 现实 ， 同 样 一 口气 就 想 学 会 所 有 
Android 探 件 的 使 用 方法 也 不 太 现 实 。 本 和 所 讲 的 内 容 对 于 你 来 说 只 是 起 到 
了 一 个 引导 的 作用 ， 你 还 需要 在 以 后 的 学 习 和 工作 中 不 断 地 摸索 ， 通 过 查 
阅 文 档 以 及 网 上 搜索 的 方式 学 习 更 多 控件 的 更 多 用 法 。 当 然 ， 当 本 书后 面 
人 ， 我 仍然 会 在 相应 的 章节 做 
详细 的 讲解 。 


3.3 ”详解 4 种 基本 布局 


一 个 丰富 的 界面 总 是 要 由 很 多 个 控件 组 成 的 ， 那 我 们 如 何 才能 让 各 个 控件 
都 有 条 不 亲 地 择 放 在 界面 上 ， 而 不 是 乱糟糟 的 呢 ? 这 就 需要 借助 布局 来 实 
现 了 。 布 局 十 一 种 可 用 于 放置 很 多 控件 的 容器 ， 它 可 以 按照 一 定 的 规律 调 
整 内 部 控件 的 位 置 ， 从 而 编写 出 精美 的 界面 。 当 然 ， 布 局 的 内 部 除了 放置 
控件 外 ， 也 可 以 放置 布局 ， 通 过 多 层 布 局 的 能 套 ， 我 们 束 能 够 完成 一 些 比 
较 复 杂 的 界面 实现 ， 图 3.15 很 好 地 展示 了 它们 之 则 的 关系 。 


图 3.15 布局 和 控件 的 关系 


下 面 我 们 来 详细 讲解 下 Android 中 4 种 最 基本 的 布局 。 先 做 好 准备 工作 ， 新 建 
一 个 UILayoutTest 项 目 ， 并 让 Android Studio 目 动 帮 有 我 们 创建 好 活动 ， 活 动 名 
和 布局 名 都 使 用 默认 值 。 


3.3.1 ”线性 布局 


LinearLayout 义 称 作 线 性 布局 ， 是 一 种 非常 常用 的 布局 。 正 如 它 的 名 字 所 揪 
述 的 一 样 ， 这 个 布局 会 将 它 所 包含 的 控件 在 线性 方向 上 依次 排列 。 相 信 你 
之 前 也 已 经 注意 到 了 ， 我 们 在 上 一 市 中 学 习 控 件 用 法 时 ， 所 有 的 控件 就 都 
ee 因此 上 一 万 中 的 控件 也 确实 是 在 垂直 方向 上 
线性 排列 的 。 


既然 是 线性 排列 ， 肯 定 了 驶 不仅 只 有 一 个 方向 ， 那 为 什么 上 一 志 中 的 控件 都 
是 在 垂直 方 回 排 列 的 呢 ? 这 是 由 于 我 们 通过 android:orientation 属性 指定 
了 排列 方 癌 是 vertical， 如 果 指 定 的 是 horizontal， 控 件 束 会 在 水 平方 喇 上 排 
列 了 。 下 面 我 们 通过 实战 来 体会 一 下 ， 修 改 activity_main.xml 中 的 代码 ， 如 
下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/buttoni1" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="Button 1" /> 


<Button 
android:id="@+id/button2" 
android:layout_width="wrap_content" 


android:layout_height="wrap_content" 
android:text="Button 2" /> 


<Button 
android:id="@+id/button3" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="Button 3" /> 


</LinearLayout> 


我 们 在 LinearLayout 中 添加 了 3 个 Button， 每 个 Button 的 长 和 宽 都 是 
wrap_content ， 并 指定 了 排列 方向 是 vertical。 现 在 运行 一 下 程序 ， 效 果 如 
图 3.16 所 示 。 


UILayoutTest 


BUTTON 1 


BUTTON 2 


BUTTON 3 


图 3.16 ”LinearLayout 垂 直 排 列 
然后 我 们 修改 一 下 LinearLayout 的 排列 方 同 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


</LinearLayout> 


将 android:orientation 属性 的 值 改 成 了 horizontal， 这 就 意味 着 要 让 
LinearLayout 中 的 控件 在 水 平方 向 上 依次 排列 。 当 然 如 果 不 指 定 
android:orientation 属性 的 值 ， 默 认 的 排列 方向 就 是 horizontal。 重 新 运行 
一 下 程序 ， 效 果 如 图 3.17 所 示 。 
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图 3.17 LinearLayout 水 平 排列 


这 里 需要 注意 ， 如 果 LinearLayout 的 排列 方 呵 是 horizontal， 内 部 的 控件 就 绝 
对 不 能 将 宽度 指定 为 natch_parent ， 因 为 这 样 的 话 ， 单 独 一 个 控件 就 会 将 
整个 水 平方 向 占 满 ， 其 他 的 控件 就 没有 可 放置 的 位 置 了 。 同 样 的 道理 ， 如 
果 LinearLayout 的 排列 方向 是 vertical， 内 部 的 控件 就 不 能 将 高 度 指定 为 


match_parent ° 


首先 来 看 android:1layout_gravity 属性 ， 它 和 我 们 上 一 节 中 学 到 的 
android:gravity 属性 看 起 来 有 些 相似 ， 这 两 个 属性 有 什么 区 别 呢 ? 其 实 从 
名 字 束 可 以 看 出 ，android:gravity 用 于 指定 文字 在 控件 中 的 对 齐 方式 ， 而 
android:layout_gravity 用 于 指定 控件 在 布局 中 的 对 齐 方 式 。 
android:layout_gravity 的 可 选 值 和 android:gravity 差不多 ， 但 是 需要 注 
意 ， 当 LinearLayout 的 排列 方向 是 horizontal 时 ， 只 有 垂直 方向 上 的 对 齐 方式 
会 生效 ， 因 为 此 时 水 平方 向 上 的 长 度 是 不 固定 的 ， 每 添加 一 个 控件 ， 水 
平方 向 上 的 长 度 都 会 改变 ， 因 而 无 法 指定 该 方向 上 的 对 齐 方式 。 同 样 的 道 


理 ， 当 LinearLayout 的 排列 方 癌 是 vertical 时 ， 只 有 水 平方 同上 的 对 齐 方式 才 
会 生效 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/buttoni1" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="top" 
android:text="Button 1" /> 


<Button 
android:id="@+id/button2" 
android:layout_width="wrap_content" 


android:layout_height="wrap_content" 
android:layout_gravity="center_vertical" 
android:text="Button 2" /> 


<Button 
android:id="@+id/button3" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="bottom" 
android:text="Button 3" /> 


</LinearLayout> 


由 于 目前 LinearLayout 的 排列 方向 是 horizontal， 因 此 我 们 只 能 指定 垂直 方 回 
上 的 排列 方向 ， 将 第 一 个 Button 的 对 齐 方式 指定 为 tp， 第 二 个 Button 的 对 齐 
方式 指定 为 center_vertical， 第 二 个 Button 的 对 齐 方 式 指定 为 bottom 。 重 新 运 
行程 序 ， 效 果 如 图 3.18 所 示 。 
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图 3.18 ”指定 layout_gravity 的 效果 


接 下 来 我 们 学 习 下 LinearLayout 中 的 男 一 个 重要 属性 一 一 

android:layout weight ° 这 个 属性 允许 我 们 使 用 比例 的 方式 来 指定 控件 的 
大 小 ， 它 在 手机 屏幕 的 适 配 性 方面 可 以 起 到 非常 重要 的 作用 。 比 如 我 们 正 
在 编写 一 个 消息 发 送 界面 ， 需 要 一 个 文本 编辑 框 和 一 个 发 送 按 钮 ， 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<EditText 
android:id="@+id/input_message" 
android:layout_width="Qdp" 
android:layout_height="wrap_content" 
android:layout_ weight="1" 
android:hint="Type something" 
/> 


<Button 
android:id="@+id/send" 
android:layout_width="Qdp" 


android:layout_height="wrap_content" 
android:layout_weight="1" 
android:text="Send" 

/> 


</LinearLayout> 


你 会 发 现 ， 这 里 竟然 将 EditText 和 Button 的 宽度 都 指定 成 了 0dp， 这 样 文本 编 
辑 框 和 按钮 还 能 显示 出 来 吗 ? 不 用 担心 ， 由 于 我 们 使 用 了 
android:layout_weight 属性 ， 此 时 控件 的 宽度 就 不 应 该 再 由 


android:layout_width 来 决定 ， 这 里 指定 成 0dp 是 一 种 比较 规范 的 写法 。 另 
外 ，dp 是 Android 中 用 于 指定 控件 大 小 、 间 距 等 属性 的 单位 ， 后 面 我 们 还 会 
经 常用 到 它 。 


然后 在 EditText 和 Button 里 都 将 android:1ayout_weight 属性 的 值 指定 为 1 
这 表示 EditText 和 Button 将 在 水 平方 向 平分 宽度 。 


为 什么 将 android:layout_weight 属性 的 值 同时 指定 为 1 就 会 平分 屏幕 宽度 
呢 ? 其 实 原理 也 很 简单 ， 系 统 会 先 把 LinearLayout 下 所 有 控件 指定 的 
layout_weight 值 相 加 ， 得 到 一 个 总 值 ， 然 后 每 个 控件 所 占 大 小 的 比例 就 是 
用 该 控件 的 layout_weight 值 除 以 刚才 算出 的 总 值 。 因 此 如 果 想 让 EditText 
占据 屏幕 宽度 的 35，Button 占 据 屏幕 宽度 的 205， 只 需要 将 EditText 的 
layout_weight 改 成 3，Button 的 layout_weight 改 成 2 职 可 以 了 。 


重新 运行 程序 ， 你 会 看 到 如 图 3.19 所 示 的 效果 。 


wk 
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图 3.19 指定 layout_weight 的 效果 


我 们 还 可 以 通过 指定 部 分 控件 的 layout_weight 值 来 实现 更 好 的 效果 。 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<EditText 
android:id="@+id/input_message" 
android:layout_width="Qdp" 
android:layout_height="wrap_content" 
android:layout_ weight="1" 
android:hint="Type something" 
/> 


<Button 
android:id="@+id/send" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="Send" 
/> 


</LinearLayout> 


| 


这 里 我 们 仅 指 定 了 EditText 的 android: 1ayout_weight 属性 ， 并 将 Button 的 宽 
度 改 回 wrap_content 。 这 表示 Button 的 宽度 仍然 按照 wrap_content 来 计算 ， 
而 EditText 则 会 占 满 屏幕 所 有 的 剩余 空间 。 使 用 这 种 方式 编写 的 界面 ， 不 仅 
在 各 种 屏 幕 的 适 配 方面 会 非常 好 ， 而 且 看 起 来 也 更 加 舒服 。 重 狐 运 行程 
序 ， 效 果 如 图 3.20 所 示 。 
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图 3.20 使 用 layout_weight 实现 宽度 自 适 配 效 果 
3.3.2 ”相对 布局 


RelativeLayout 义 称 作 相 对 布局 ， 也 是 一 种 非常 常用 的 布局 。 和 LinearLayout 
的 排列 规则 不 同 ，RelativeLayout 显 得 更 加 随意 一 些 ， 它 可 以 通过 相对 定位 
的 方式 让 控件 出 现在 布局 的 任何 位 置 。 也 正 因为 如 此 ，RelativeLayout 中 的 
属性 非常 多 ， 不 过 这 些 属性 都 是 有 规律 可 循 的 ， 其 实 并 不 难 理解 和 记忆 。 


我 们 还 是 通过 实践 来 体会 一 个， 修改 activity_main.xml 中 的 代码 ， 如 下 所 
人 小 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/buttoni1" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_alignParentLeft="true" 
android:layout_alignParentTop="true" 
android:text="Button 1" /> 


<Button 
android:id="@+id/button2" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_alignParentRight="true" 
android:layout_alignParentTop="true" 
android:text="Button 2" /> 


<Button 
android:id="@+id/button3" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_centerInpParent="true" 
android:text="Button 3" /> 


<Button 
android:id="@+id/button4" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_alignParentBottom="true" 
android:layout_alignParentLeft="true" 
android:text="Button 4" /> 


<Button 
android:id="@+id/button5s" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_alignParentBottom="true" 
android:layout_alignParentRight="true" 
android:text="Button 5" /> 


</RelativeLayout> 


我 想 以 上 代码 已 经 不 需要 我 再 做 过 多 解释 了 ， 因 为 实在 是 太 好 理解 了 。 我 
们 让 Button 1 和 父 布局 的 左上 角 对 齐 ，Button 2 和 父 布局 的 右上 角 对 齐 ， 
Button 3 居中 显示 ，Button 4 和 父 布局 的 左下 角 对 齐 ，Button 5 和 父 布局 的 右 
下 角 对 齐 。 虽然 android:layout_alignParentLeft 


android:layout_alignParentTop 、 android:]layout_alignParentRight 、 
android:layout_alignParentBottom 、 android:layout_centerIinpParent 这 几 


个 属性 我 们 之 前 都 没 接触 过 ， 可 是 它们 的 名 字 已 经 完全 说 明了 它们 的 作 
用 。 重 新 运行 程序 ， 效 有 果 如 图 3.21 所 示 。 
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图 3.21 相对 于 父 布局 定位 的 效果 


上 面 例子 中 的 每 个 控件 都 是 相对 于 父 布局 进行 定位 的 ， 那 控件 可 不 可 以 相 
对 于 控件 进行 定位 呢 ? 当然 是 可 以 的 ， 修 改 activity_main.xml 中 的 代码 ， 如 


下 所 示 : 


<RelativeLayout 


<Button 
android 
android 
android 


android: 
android: 


<Button 
android 
android 


android: 


xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


:id="@+id/button3" 
:layout_width="wrap_content" 
:layout_height="wrap_content" 


layout_centerInParent="true" 
text="Button 3" /> 


:id="@+id/buttoni" 
:layout_width="wrap_content" 


layout_height="wrap_content" 


android:layout_above="@id/button3" 
android:layout_toLeftOof="@id/button3" 


android:text="Button 1" 


<Button 


/> 


android:id="@+id/button2" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_above="@id/button3" 
android:layout_toRightof="@id/button3" 


android:text="Button 2" 


<Button 


/> 


android:id="@+id/button4" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_below="@id/button3" 
android:layout_toLeftOof="@id/button3" 


android:text="Button 4" 


<Button 


/> 


android:id="@+id/button5s" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_below="@id/button3" 
android:layout_toRightof="@id/button3" 


android:text="Button 5" 


</RelativeLayout> 


/> 


这 次 的 代码 稍微 复杂 一 点 ， 不 过 仍然 是 有 规律 可 循 的 。 
android:layout_above 属性 可 以 让 一 个 控件 位 于 男 一 个 控件 的 上 方 ， 需 要 为 
这 个 属性 指定 相对 控件 id 的 3 引用， 这 里 我 们 填 入 了 @id/button3 ， 表 示 让 该 


控件 位 于 Button 3 的 上 方 


。 其 他 的 属性 也 都 是 相似 的 ，android: 


layout_below 表示 让 一 个 控件 位 于 另 一 个 控件 的 下 方 ， 
android:layout_toLeftof 表示 让 一 个 控件 位 于 男 一 个 控件 的 左 侧 ， 
android:1layout_toRightof 表示 让 一 个 控件 位 于 男 一 个 控件 的 右 侧 。 注 意 ， 
当 一 个 控件 去 引用 另 一 个 控件 的 id 时 ， 该 控件 一 定 要 定义 在 引用 控件 的 后 
面 ， 不 然 会 出 现 找 不 到 id 的 情况 。 重 新 运行 程序 ， 效 果 如 图 3.22 所 示 。 
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图 3.22 相对 于 控件 定位 的 效果 


RelativeLayout 中 还 有 另外 一 组 相对 于 控件 进行 定位 的 属性 ， 
android:layout_alignLeft 表示 让 一 个 控件 的 左边 缘 和 另 一 个 控件 的 左边 缘 
对 齐 ，android:layout_alignRight 表示 让 一 个 控件 的 右边 综 和 男 一 个 控件 
的 右边 缘 对 齐 。 此 外 ， 还 有 android:1layout_alignTop 和 
android:layout_alignBottom ， 道 理 都 是 一 样 的， 我 束 不 再 多 说 ， 这 几 个 属 
性 就 留 给 你 目 己 去 尝试 吧 。 


好 了 ， 正 如 我 前 面 所 说 ，RelativeLayout 中 的 属性 虽然 多 ， 但 都 是 有 规律 可 
循 的 ， 所 以 学 起 来 一 点 都 不 觉得 吃力 吧 ? 


3.3.3” 帧 布局 


FrameLayout 又 称 作 帧 布局 ， 它 相 比 于 前 面 两 种 布局 整 简 单 太 多 了 ， 因 此 它 
的 应 用 场景 也 少 了 很 多 。 这 种 布局 没有 方便 的 定位 方式 ， 所 有 的 控件 都 会 


默认 摆 放 在 布局 的 左上 角 。 让 我 们 通过 例子 来 看 一 看 吧 ， 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:id="@+id/text_view" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="This is TextView" 
/> 


<ImageView 
android:id="@+id/image_view" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:src="@mipmap/ic_launcher" 
/> 


</FrameLayout> 


FrameLayout 中 只 是 放置 了 一 个 TextView 和 一 个 ImageView。 需 要 注意 的 是 ， 
当前 项 目 我 们 没有 准备 任何 图 片 ， 所 以 这 里 ImageView 直 接 使 用 了 @mipmap 
来 访问 ic _launcher 这 张 图 ， 虽 说 这 种 用 法 的 场景 可 能 非常 少 ， 但 我 还 是 要 上 告 
诉 你 ， 这 是 完全 可 行 的。 重新 运行 程序 ， 效果 如 图 323 所 示 ® 
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图 3.23 FrameLayout 运 行 效果 


可 以 看 到 ， 文 字 和 图 片 都 是 位 于 布局 的 左上 角 。 由 于 ImageView 是 在 
TextView 之 后 添加 的 ， 因 此 图 片 压 在 了 文字 的 上 面 。 


当然 除了 这 种 默认 效果 之 外 ， 我 们 还 可 以 使 用 layout_gravity 属性 来 指定 
控件 在 布局 中 的 对 齐 方式 ， 这 和 LinearLayout 中 的 用 法 是 相似 的 。 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android 
android 
android 
android 


android: 


/> 


<ImageView 
android 


:id="@+id/text_view" 
:layout_width="wrap_content" 
:layout_height="wrap_content" 
:layout_gravity="left" 


text="This is TextView" 


:id="@+id/button" 


android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="right" 
android:src="@mipmap/ic_launcher" 


/> 


</FrameLayout> 


我 们 指定 TextView 在 FrameLayout 中 居 左 对 齐 ， 指 定 ImageView 在 


FrameLayout 中 居 右 对 齐 


， 然 后 重新 运行 程序 ， 效 有 果 如 图 3.24 所 示 。 
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图 3.24 指定 layout_gravity 的 效果 


忌 体 来 讲 ，FrameLayout 


由 于 定位 方式 的 欠缺 ， 导 致 它 的 应 用 场景 也 比较 


少 ， 不 过 在 下 一 章 中 介绍 雁 族 的 时 候 我 们 还 是 可 以 用 到 它 的 。 


3.3.4 百分比 布局 


前 面 介绍 的 3 种 布局 都 是 从 Android 1.0 版 本 中 就 开始 支持 了 ， 一 直 沿 用 到 现 
在 ， 可 以 说 是 满足 了 绝 大 多 数 场景 的 界面 设计 和 需求。 不 过 细心 的 你 会 发 

;内 有 LinearLayout 文 持 使 用 layout_weight 属性 来 实现 按 比 例 指定 控件 
大 小 的 功能 ， 其 他 两 种 布局 都 不 支持 。 比 如 说 ， 如 采 想 用 RelativeLayout 来 
实现 让 两 个 按钮 平 分 布局 宽度 的 效果 ， 则 是 比较 困难 的 。 


为 此 ，Android 引 入 了 一 种 全 新 的 布局 方式 来 解决 此 问题 一 一 百分比 布局 。 
在 这 种 布局 中 ， 我 们 可 以 不 再 使 用 wrap_content 、match_parent 等 方式 来 
指定 控件 的 大 小 ， 而 是 允许 直接 指定 控件 在 布局 中 所 占 的 百分比 ， 这 样 的 
话 就 可 以 轻松 实现 平分 布局 甚至 是 任意 比例 分 割 布局 的 效果 了 。 


由 于 LinearLayout 本 吴 已 经 文 持 按 比例 指定 控件 的 大 小 了 ， 因 此 百分比 布局 
只 为 FrameLayout 和 RelativeLayout 进 行 了 功能 扩展 ， 提 供 了 
PercentFrameLayout 和 PercentRelativeLayout 这 两 个 全 新 的 布局 ， 下 面 我 们 就 
来 具体 学 习 一 


不 同 于 前 3 种 布局 ， 百 分 比 布 局 属于 新 增 布 局 ， 那 么 怎么 才能 做 到 让 新 增 布 
局 在 所 有 Android 版 本 上 都 能 使 用 呢 ? 为 此 ，Android 团 队 将 百分比 布局 定义 
在 了 support 库 当中 ， 我 们 只 需要 在 项 目的 build.gradle 中 添加 百分比 布局 库 的 
依赖 ， 就 能 保证 百分比 布局 在 Android 所 有 系统 版 本 上 的 兼容 性 了 。 


打开 app/build.gradle 文 件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android.support:appcompat-v7:24.2.1" 
compile 'com.android.support:percent:24.2.1" 
testCompile 'junit:junit:4.12"' 


} 


需要 注意 的 是 ， 每 当 修改 了 任何 gradle 文 件 时 ，Android Studio 都 会 弹出 一 个 
如 图 3.25 所 示 的 提示 。 


= ER 于 下 和 
| Gradle files have changed since last project sync. A project sync may be necessary for the IDE to work properly. SyncNow | 


图 3.25 ”gradle 文 件 修 改 后 的 提示 


这 个 提示 告诉 我 们 ，gradle 文 件 目 上 次 同步 之 后 义 发 生 了 变化 ， 需 要 再 次 同 
步 才能 使 项 目 正 常 工作 。 这 里 只 \ 第 要 后 击 Sync Now 就 可 以 了 ， 然 后 gradle 会 
开始 进行 同步 ， 把 我 们 新 添加 的 百分比 布局 库 引 入 到 项 目 当 中 。 


接 下 来 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<android.Ssupport,percent ,PercentFrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/buttoni1" 
android:text="Button 1" 
android:layout_gravity="left|top" 
app:layout_widthPercent="50%" 
app:layout_heightPercent="50%" 
/> 


<Button 
android:id="@+id/button2" 
android:text="Button 2" 
android:layout_gravity="right|top" 
app:layout_widthPercent="50%" 
app:layout_heightPercent="50%" 
/> 


<Button 
android:id="@+id/button3" 
android:text="Button 3" 
android:layout_gravity="left|bottom" 
app:layout_widthPercent="50%" 
app:layout_heightPercent="50%" 
/> 


<Button 
android:id="@+id/button4" 
android:text="Button 4" 
android:layout_gravity="right|bottom" 
app:layout_widthPercent="50%" 
app:layout_heightPercent="50%" 
/> 


</android.support.percent.PercentFrameLayout> 


最 外 层 我 们 使 用 了 PercentFrameLayout， 由 于 百分比 布局 并 不 是 内 置 在 系统 
SDK 当 中 的 ， 所 以 需要 把 完整 的 包 路 径 写 出 来 。 深 后 还 不 必须 定义 一 个 app 的 
命名 空间 ， 这 样 才 能 使 用 百分比 布局 的 自 定 义 属 性 


在 PercentFrameLayout 中 我 们 定义 了 4 个 按钮 ， 使 用 
app:layout_widthPercent 属性 将 各 按钮 的 宽度 指定 为 布局 的 509%， 使 用 
app:layout_heightPercent 属性 将 各 按钮 的 高 度 指定 为 布局 的 50%。 这 里 之 
所 以 能 使 用 app 前 级 的 属性 就 是 因为 刚才 定义 了 app 的 命名 空间 ， 当 然 我 们 
一 直 能 使 用 android 前 级 的 属性 也 是 同样 的 道理 。 


不 过 PercentFrameLayout 还 是 会 继承 FrameLayout 的 特性 ， 即 所 有 的 控件 默认 
都 是 摊 放 在 布局 的 左上 角 。 那 么 为 了 让 这 4 个 按钮 不 会 重合 ， 这 里 还 是 借助 
了 1layout_gravity 来 分 别 将 这 4 个 按钮 放置 在 布局 的 左上 上、 石上 上、 左下 、` 硬 
下 4 个 位 置 。 


现在 我 们 已 经 可 以 重新 运行 程序 了 ， 不 过 如 果 你 使 用 的 是 老 版 本 的 Android 
Studio， 可 能 会 在 activity_main.xml 中 看 到 一 些 如 图 3.26 所 示 的 错误 提示 。 


ayout height' attribute should be defined more... (Ctr|+F1) | 
ayout_width' attribute should be defined more... (Ctr|+F1) | 


图 3.26 activity_main.xml 中 错误 提示 
这 是 因为 老 版 本 的 Android Studio 中 内 置 了 布局 的 检查 机 制 ， 认 为 每 一 个 控 


件 都 应 该 通过 and roid:layout_width android: layout_height 属性 指定 宽 
高 才 是 合法 的 。 而 其 实 我 们 是 通过 app:1layout_widthpercent 和 
app:layout_heightPercent 属性 来 指定 宽 高 的 ， 所 以 Android Studio 没 检测 
到 。 不 过 这 个 错误 提示 并 不 影响 程序 运行 ， 我 们 直接 忽视 就 可 以 了 。 当 然 
最 新 的 Android Studio 2.2 版 本 中 已 经 修复 了 这 个 问题 ， 因 此 你 可 能 并 不 会 看 
到 上 述 的 错误 提示 。 


现在 重新 运行 程序 ， 效 有 果 如 图 3.27 所 示 。 


UILayoutTest 


BUTTON 1 BUTTON 2 


图 3.27 PercentFrameLayout 运 行 效果 


可 以 看 到 ， 每 一 个 按钮 的 宽 和 高 都 占据 了 布局 的 50%， 这 样 我 们 就 轻松 实现 
了 4 个 按钮 平分 屏幕 的 效果 。 


PercentFrameLayout 的 用 法 就 介绍 到 这 里 ， 男 外 一 个 PercentRelativeLayout 的 
用 法 也 是 非常 相似 的 ， 它 继承 了 RelativeLayout 中 的 所 有 属性 ， 并 且 可 以 使 
用 app:1layout_widthPercent 和 app:1layout_heightPercent 来 按 百分比 指定 
控件 的 宽 高 ， 相 信 聪 明 的 你 一 定 可 以 举一反三 了 。 

这 样 我 们 就 把 最 常用 的 几 种 布局 都 讲解 完了 ， 其 实 Android 中 还 有 
AbsoluteLayout、TableLayout 等 布局 ， 不 过 由 于 使 用 得 实在 是 太 少 了 ， 就 不 
在 本 书 中 进行 讲解 了 。 


3.4 系统 控件 不 够 用 ?创建 目 定义 控件 


在 前 面 两 节 我 们 已 经 学 习 了 Android 中 的 一 些 常用 控件 以 及 基本 布局 的 用 
法 ， 不 过 当时 我 们 并 没有 关注 这 些 控件 和 布局 的 继承 结构 ， 现 在 是 时 候 来 
看 一 下 了 ， 如 图 3.28 所 示 。 


View 


ImasgeView 


图 3.28 ”常用 控件 和 布局 的 继承 结构 


可 以 看 到 ， 我 们 所 用 的 所 有 控件 都 是 直接 或 间接 继承 目 View 的 ， 所 用 的 所 
有 布局 都 是 直接 或 间接 继承 目 ViewGroup 的 。View 是 Android 中 最 基本 的 一 
种 UI 组 件 ， 它 可 以 在 屏幕 上 绘制 一 块 矩 形 区 域 ， 并 能 啊 应 这 块 区 域 的 各 种 
事件 ， 因 此 ， 我 们 使 用 的 各 种 控件 其 实 就 是 在 View 的 基础 之 上 又 添加 了 各 
自 特 有 的 功能 。 而 ViewGroup 则 是 一 种 特殊 的 View， 它 可 以 包含 很 多 子 View 
和 子 ViewGroup， 是 一 个 用 于 放置 控件 和 布局 的 容器 。 


这 个 时 候 我 们 就 可 以 思考 一 下 ， 当 系统 自 带 的 控件 并 不 能 满足 我 们 的 需求 
时 ， 可 不 可 以 利用 上 面 的 继承 结构 来 创建 目 定义 控件 呢 ? 答案 是 肯定 的 ， 
下 面 我 们 束 来 学 习 一 下 创建 自 定 义 探 件 的 两 种 和 倘 单 方法 。 移 将 准备 工作 做 
好 ， 创 建 一 个 UICustomViews 项 目 。 


3.4.1 引入 布局 


如 果 你 用 过 iPhone 应 该 会 知道 ， 几 平 个 iPhone 应 用 的 界面 顶部 都 会 有 一 
个 标题 栏 ， 标 题 栏 上 会 有 一 到 两 个 按钮 可 用 于 返回 或 其 他 操作 《iPhone 没有 
实体 返回 键 ;) 。 现 在 很 多 Android 程 序 也 都 喜欢 模仿 iPhone 的 风格 ， 在 界面 


的 顶部 放置 一 个 标题 栏 。 虽 然 Android 系 统 已 经 给 每 个 活动 提供 了 标题 栏 功 
能 ， 但 这 里 我 们 决定 先 不 使 用 它 ， 而 是 创建 一 个 目 定义 的 标题 栏 。 


经 过 前 面 两 节 的 学 习 ， 相 信 创 建 一 个 标题 栏 布局 对 你 来 说 已 经 不 是 什么 
难 的 事情 了 ， 只 需要 加 入 两 个 Button 和 一 个 TextView， 人 然后 在 布局 中 摆 放 好 
束 可 以 了 。 可 是 这 样 做 却 存在 着 一 个 问题 ， 一 般 我 们 的 程序 中 可 能 有 很 多 
个 活动 都 需要 这 样 的 标题 栏 ， 如 果 在 每 个 活动 的 布局 中 都 编写 一 遍 同样 的 
标题 栏 代码 ， 明 显 驶 会 导致 代码 的 大 量 重 复 。 这 个 时 候 我 们 束 可 以 使 用 引 
入 布局 的 方式 来 解决 这 个 问题 ， 新 建 一 个 布局 title.xml， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:background="@drawable/title_bg"> 


<Button 
android:id="@+id/title back" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:layout_margin="5dp" 
android:background="@drawable/back_bg" 
android:text="Back" 
android:textCcolor="#fff" /> 


<TextView 
android:id="@+id/title text" 
android:layout_width="Qdp" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:layout_weight="1" 
android:gravity="center" 
android:text="Title Text" 
android:textColor="#fff" 
android:textSize="24sp" /> 


<Button 
android:id="@+id/title_edit" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:layout_margin="5dp" 
android:background="@drawable/edit_bg" 
android:text="Edit" 
android:textCcolor="#fff" /> 


</LinearLayout> 


可 以 看 到 ， 我 们 在 LinearLayout 中 分 别 加 入 了 两 个 Button 和 一 个 TextView， 

左边 的 Button 可 用 于 返回 ， 右 边 的 Button 可 用 于 编辑 ， 中 间 的 TextView 则 可 
以 显示 一 段 标题 文本 。 上 面 代码 中 的 大 多 数 属性 都 是 你 已 经 见 过 的 ， 下 面 
我 来 说 明 一 下 几 个 之 前 没有 讲 过 的 属性 。android:background 用 于 为 布局 


或 控件 指定 一 个 背景 ， 可 以 使 用 颜色 或 图 片 来 进行 填充 ， 这 里 我 提请 前 准备 
好 了 3 张 图 片 一 title_bg.png、back_bg.png 和 edit_bg.png， 分 另 别 用 于 作为 标 
题 栏 、 返 回 按钮 和 编辑 按钮 的 背景 。 男 外 ， 在 两 个 Button 中 我 们 都 使 用 了 
android:layout_margin 这 个 属性 ， 它 可 以 指定 控件 在 上 下 左右 方 同 上 偏 移 
的 距离 ， 当然 也 可 以 使 用 android: :layout_marginLeft a 或 
android:layout_marginTop 等 属性 来 单独 指定 控件 在 某 个 方向 上 偏 移 的 距 
离 。 


现在 标题 栏 布局 已 经 编写 完成 了 ， 琵 下 的 束 是 如 何在 程序 中 使 用 这 个 标题 
栏 了 ， 人 和 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<include layout="@layout/title" /> 


</LinearLayout> 


没 错 ! 我 们 只 需要 通过 一 行 include 语句 将 标题 栏 布局 引入 进来 就 可 以 了 。 
最 后 别 坪 了 在 MainActivity 中 将 系统 自 带 的 标题 栏 隐 藏 挥 ， 代 码 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
ActionBar actionbar = getSupportActionBar(); 
if (actionbar != null) { 


actionbar .hide(); 


这 里 我 们 调用 了 getsupportActionBar() 方法 来 获得 ActionBar 的 实例 ， 然 后 
再 调用 ActionBar 的 hide() 方法 将 标题 栏 隐 活 起 来 。 关 于 ActionBar 的 更 多 用 
法 我 们 将 会 在 第 和 12 蕴 中 讲解 ， 现在 你 只 需要 知道 可 以 通过 这 种 写法 来 隐藏 
标题 栏 束 足够 了 。 现 在 运行 一 下 程序 ， 效 果 如 图 3.29 所 示 。 


Title Text 


图 3.29 引入 标题 栏 布局 的 效果 


使 用 这 种 方式 ， 不 管 有 多 少 布局 需要 添加 标题 栏 ， 只 需 一 行 include 语句 号 
可 以 了 。 


3.4.2 ”创建 目 定义 控件 


引入 布局 的 技巧 确实 解决 了 重复 编写 布局 代码 的 问题 ， 但 是 如 采 布 局 中 有 
一 些 控件 要 求 能 够 响应 事件 ， 我 们 还 是 需要 在 每 个 活动 中 为 这 些 控件 单独 
编写 一 次 事件 注册 的 代码 。 比 如 说 标题 栏 中 的 返回 按钮 ， 其 实 不 管 是 在 哪 
一 个 活动 中 ， 这 个 按钮 的 功能 都 是 相同 的 ， 即 销 吗 当前 活动 。 而 如 果 在 每 
一 个 活动 中 都 需要 重新 注册 一 人 过 返回 按钮 的 点 击 事 件 ， 无 疑 会 增加 很 多 重 
复 代 码 ， 这 种 情况 最 好 是 使 用 目 定义 控件 的 方式 来 解决 。 


新 建 TitleLayout 继 承 目 LinearLayout， 让 它 成 为 我 们 目 定 义 的 标题 栏 控件 ， 
代码 如 下 所 示 : 


public class TitleLayout extends LinearLayout { 


public TitleLayout(Context context, AttributeSet attrs) { 
super(context, attrs); 
LayoutInflater.from(context).inflate(R.layout.title, this); 
} 


首 移 我 们 重 写 了 LinearLayout 中 市 有 两 个 参数 的 构造 函数 ， 在 布局 中 引入 

TitleLayout 控 件 就 会 调用 这 个 构造 画 数 。 然 后 在 构造 函数 中 需要 对 标题 栏 布 
局 进行 动态 加 载 ， 这 就 要 借 oe 通过 LayoutInflater 的 
from( ) 方法 可 以 构建 出 一 个 LayoutInflater 对 象 ， 然 后 调用 inflate( ) 方法 
就 可 以 动态 加 载 一 个 布局 文件 ，inflate() 方法 接收 两 个 参数 ， 第 一 个 参数 
是 要 加 载 的 布局 文件 的 id， 这 里 我 们 传 入 R.layout.title， 第 二 个 参数 是 给 加 
i 这 里 我 们 想 要 指定 为 TitleLayout， 于 是 直接 

入 this ° 


现在 自 定义 控件 已 经 创建 好 了 ， 然 后 我 们 需要 在 布局 文件 中 添加 这 个 自 害 
义 控件 ， 1 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<com.example.uicustomviews.TitleLayout 
android:layout_width="match_parent" 


android:layout_height="wrap_content" /> 


</LinearLayout> 


添加 目 定义 控件 和 添加 普通 控件 的 方式 基本 是 一 样 的 ， 只 不 过 在 添加 目 完 
ee 包 名 人 里 是 不 可 以 省 略 


重新 运行 程序 ， 你 会 发 现 此 时 效果 和 使 用 引入 布局 方式 的 效果 是 一 样 的 。 


下 面 我 们 尝试 为 标题 栏 中 的 按钮 注册 点 击 事件 ， 修 改 TitleLayout 中 的 代码 ， 
如 下 所 示 : 


public class TitleLayout extends LinearLayout { 


public TitleLayout(Context context, AttributeSet attrs) { 
super(context, attrs); 


LayoutInflater.from(context).inflate(R.layout.title, this); 
Button titleBack = (Button) findViewById(R.id.title back); 
Button titleEdit = (Button) findViewById(R.id.title edit); 
titleBack.setOonClickListener(new OnClickListener() { 

@Override 

public void onClick(View v) { 

((Activity) getContext()).finish(); 
} 


}); 
titleEdit.setonClickListener(new OnClickListener() { 
@Override 


public void onClick(View v) { 
Toast.makeText(getContext(), "You clicked Edit button", 
Toast .LENGTH_SHORT) .show( ); 


}); 


首先 还 
seepneten teerer 和 人 台 两 个 按钮 注册 了 点 击 事件 ， _ 当 点 击 返 加 扩 时 


叹 掉 当前 的 活动 ， 当 点 击 编辑 按钮 时 弹出 一 段 文本 。 重 新 运行 程序 ， 
下 编辑 按钮 ， 效 果 如 图 3.30 所 示 。 


过 findviewById() 方法 得 到 按钮 的 实例 ， 然 后 分 别 调用 


点 


Title Text 


You clicked Edit button 


图 3.30 点击 编辑 按钮 的 效果 


这 样 的 话 ， 每 当 我 们 在 一 个 布局 中 引入 TitleLayout 时 ， 返 回 按钮 和 编辑 按钮 
的 点 击 事件 残 已 经 目 动 实 现 好 了 ， 这 束 省 去 了 很 多 编写 重复 代码 的 工作 。 


3.5 ”最 常用 和 最 难 用 的 控件 一 一 


ListView 


ListView 绝 对 可 以 称 得 上 是 Android 中 最 常用 的 控件 之 一 ， 几 乎 所 有 的 应 用 
程序 都 会 用 到 它 。 由 于 手机 屏幕 空间 都 比较 有 限 ， 能 够 一 次 性 在 屏幕 上 显 
示 的 内 容 并 不 多 ， 当 我 们 的 程序 中 有 大 量 的 数据 需要 展示 的 时 候 ， 束 可 以 
借助 ListView 来 实现 。ListView 人 允许 用 户 通过 手指 上 下 请 动 的 方式 将 屏幕 外 
的 数据 滚动 到 屏幕 内 ， 同 时 屏幕 上 原 有 的 数据 则 会 滚动 出 屏幕 。 相 信 你 其 
实 每 天 者 在 使 用 这 个 控件 ， 比 如 至 看 QQ 散 大 记录 ， 翻 阅 全 倍 最 新 注 息 ， 守 


不 过 比 起 前 面 介绍 的 几 种 控件 ，ListView 的 用 法 也 相对 复杂 了 很 多 ， 因 此 我 
们 就 单独 使 用 一 节 内 容 来 对 ListView 进 行 非常 详细 的 讲解 。 


3.5.1 _ ListView 的 简单 用 法 


首先 新 建 一 个 ListViewTest 项 目 ， 并 让 Android Studio 上 自动 帮 有 我 们 创建 好 活 


动 。 然 后 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<ListView 
android:id="@+id/list_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" /> 


</LinearLayout> 


在 布局 中 加 入 ListView 控 件 还 复 非 党 简单， 先 为 ListView 指 定 一 个 id， 然 后 
将 宽度 和 高 度 都 设置 为 natch_ parent ， 这 样 ListView 也 就 占 满 了 整个 布局 的 


空间 。 
接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private String[] data = { "Apple", "Banana", "Orange", "Watermelon", 
"Pear", "Grape", "Pineapple", "Strawberry", "Cherry", "Mango", 
"Apple", "Banana", "Orange", "Watermelon", "Pear", "Grape", 
"Pineapple", "Strawberry", "Cherry", "Mango" }; 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 


setCcontentView(R.1layout.activity_main); 

ArrayAdapter<String> adapter = new ArrayAdapter<String>( 
MainActivity.this, android.R.1layout.simple list_item 1, data); 

ListView listView = (ListView) findViewById(R.id.]1ist view); 

JistView,.setAdapter(adapter); 


既然 ListView 是 用 于 展示 大 量 数 据 的 ， 那 我 们 束 应 该 先 将 数据 提供 好 。 这 些 
数据 可 以 是 从 网 上 下 载 的 ， 也 可 以 是 从 数据 库 中 读 取 的 ， 应 该 视 具体 的 应 


用 程序 场景 而 定 。 这 里 我 们 整 简 单 使 用 了 一 个 data 数 组 来 测试 ， 里 面包 含 了 
很 多 水 果 的 名 称 。 


不 过 ， 数 组 中 的 数据 是 无 法 直接 传递 给 ListView 的 ， 我 们 还 需要 借助 适配器 
来 完成 。Android 中 提供 了 很 多 适 配 妖 的 实现 类 ， 其 中 我 认为 最 好 用 的 就 是 
ArrayAdapter。 它 可 以 通过 泛 型 来 指定 要 适 配 的 数据 类 型 ， 然 后 在 构造 本 数 
中 把 要 适 配 的 数据 传 入 。ArrayAdapter 有 多 个 构造 玉 数 的 重 载 ， 你 应 该 根据 
实际 情况 选择 最 合适 的 一 种 。 这 里 由 于 我 们 提供 的 数据 都 是 字符 串 ， 因 此 

将 ArrayAdapter 的 泛 型 指定 为 string ， 然 后 在 ArrayAdapter 的 构造 函数 中 依 
次 传 入 当前 上 下 文 、ListView 子 项 布局 的 id， 以 及 要 适 配 的 数据 。 注 意 ， 我 
们 使 用 了 android.R. layout.simple_list_item 1 作为 ListView 子 项 布局 的 

id， 这 是 一 个 Android 内 置 的 布局 文件 ， 里 面 只 有 一 个 TextView， 可 用 于 简 

单 地 显示 一 段 文 本 。 这 样 适 配 右 对 象 束 构 建 好 了 了。 


最 后 ， 还 需要 调用 ListView 的 setAdapter() 方法 ， 将 构建 好 的 适配器 对 象 传 
递 进去 ， 这 样 ListView 和 数据 之 间 的 关联 就 建立 完成 了 。 


Or 程序， 效果 如 图 3.31 所 示 。 可 以 通过 滚动 的 方式 来 查看 屏幕 外 
9 数据 。 
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图 3.31 ListView 运 行 效果 


3.5.2 ”定制 ListView 的 界面 


只 能 显示 一 段 文本 的 ListView 实 在 是 太 单调 了 ， 我 们 现在 就 来 对 ListView 的 
界面 进行 定制 ， 让 它 可 以 显示 更 加 丰富 的 内 容 。 


首先 需要 准备 好 一 组 图 片 ， 分 别 对 应 上 面 提供 的 每 一 种 水 果 ， 待 会 我 们 要 
让 这 些 水 果 名 称 的 旁边 都 有 一 个 图 样 。 


接着 定义 一 个 实体 类 ， 作 为 ListView 适 配器 的 适 配 类 型 。 新 建 类 Fruit ， 代 
码 如 下 所 示 : 


public class Fruit { 


private String name; 
private int imageId ; 


public Fruit(String name, int imageId) { 


this.name = name ， 
this,imageId = imageId ， 


} 


public String getName() { 
return name; 


} 


public int getImageId() { 
return imageId ; 
上 


Fruit 类 中 只 有 两 个 字段 ，name 表示 水 果 的 名 字 ，imageId 表示 水 果 对 应 图 
片 的 资源 id 。 


然后 需要 为 ListView 的 子 项 指定 一 个 我 们 自 定义 的 布局 ， 在 layout 目 录 下 新 
建 fruit_item.xml， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 


<ImageView 
android:id="@+id/fruit_image" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" /> 


<TextView 
android:id="@+id/fruit_name" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_vertical" 
android:layout_marginLeft="10dp" /> 


</LinearLayout> 


在 这 个 布局 中 ， ed 显示 水 果 的 图 片 ， 又 定义 了 
一 个 TextView 用 于 显示 水 果 的 名 称 ， 并 让 TextView 在 生 直 方向 上 居中 显示 。 


接 下 来 需 要 创建 一 个 目 定义 的 适配器 ， 这 个 适配器 继承 自 ArrayAdapter， 并 
将 泛 型 指定 为 Fruit 类 。 新 建 类 FruitAdapter ， 代 码 如 下 所 示 : 


public class FruitAdapter extends ArrayAdapter<Fruit> { 


private int resourceld,; 


public FruitAdapter(Context context, int textViewResourcelId, 
List<Fruit> objects) { 


Super(context，textViewResourceId，objects ) ， 
resourceId = textViewResourcelId; 


} 


QOverride 

public View getView(int position, View convertView, ViewGroup parent) { 
Fruit fruit = getItem(position); // 获取 当前 项 的 Fruit 实 例 
View view = LayoutInflater.from(getContext()).inflate(resourceId, parent, 

false); 

ImageView fruitImage = (ImageView) view.findViewById(R.id.fruit_ image); 
TextView fruitName = (TextView) view.findViewById(R.id.fruit_name); 
fruitImage.setImageResource(fruit.getIimageId()); 
fruitName.setText(fruit.getName()); 
return view; 


FruitAdapter 重 写 了 父 类 的 一 组 构造 畏 数 ， 用 于 将 上 下 文 、ListView 子 项 布 


局 的 id 和 数据 都 传递 进来 。 另 外 又 重 写 了 getview() 方法 ， 这 个 方法 在 每 个 
子 项 被 滚动 到 屏 攻 内 的 时 候 会 被 调用 。 在 getview() 方法 中 ， 首 多 通过 
etItem() 方法 得 到 当前 项 的 Fruit 实 例 ， 然后 使 用 LayoutInflater 来 为 这 个 
子 项 加 载 我 们 传 入 的 布局 。 


这 里 LayoutInflater 的 inflate() 方法 接收 3 个 参数 ， 前 两 个 参数 我 们 已 经 

知道 是 什么 意思 了 ， 第 三 个 参数 指定 成 false ， 表 示 只 让 我 们 在 父 布局 中 声 
明 的 layout 属性 生效 ， 但 不 会 为 这 个 View 添 加 父 布局 ， 因 为 一 旦 View 有 了 
父 布局 之 后 ， 它 就 不 能 再 添加 到 ListView 中 了 “。 如 果 你 现在 还 不 能 理解 这 段 
话 的 含义 也 没关系 ， 只 需要 知道 这 是 ListView 中 的 标准 写法 就 可 以 了 ， 当 你 
以 后 对 View 理 解 得 更 加 深刻 的 时 候 ， 再 来 读 这 上 段 话 就 没有 问题 了 。 


我 们 继续 往 下 看 ， 接 下 来 调用 View 的 findviewById() 方法 分 别 获 取 到 
ImageView 和 TextView 的 实例 ， 并 分 别 调用 它们 的 setImageResource() 和 
setText() 方法 来 设置 显示 的 图 片 和 文字 ， 最 后 将 布局 返回 ， 这 样 我 们 自 定 
义 的 适配器 就 完成 了 。 


下 面 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


© 


public class MainActivity extends AppCompatActivity { 


private List<Fruit> fruitList = new ArrayList<>()， 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
initFruits(); // 初始 化 水 果 数 据 
FruitAdapter adapter = new FruitAdapter(MainActivity.this， 


R.layout.fruit_item, fruitList); 


ListView listView = (ListView) findViewById(R.id.]1ist view); 
JistView,.setAdapter(adapter); 


} 


private void initFruits() { 
for (int i = 0; i < 2; i++) { 


Fruit apple = new Fruit("Apple", R.drawable.apple_pic); 
fruitList.add(apple); 

Fruit banana = new Fruit("Banana", R.drawable.banana pic); 
fruitList.add(banana); 

Fruit orange = new Fruit("Orange", R.drawable.orange pic); 
fruitList.add(orange); 

Fruit watermelon = new Fruit("Watermelon", R.drawable.watermelon_pic); 
fruitList.add(watermelon); 

Fruit pear = new Fruit("Pear", R.drawable.pear_pic); 
fruitList.add(pear); 

Fruit grape = new Fruit("Grape", R.drawable.grape_pic); 
fruitList.add(grape); 

Fruit pineapple = new Fruit("Pineapple", R.drawable.pineapple_pic); 
fruitList.add(pineapple); 

Fruit strawberry = new Fruit("Strawberry", R.drawable.strawberry_pic); 
fruitList.add(strawberry); 

Fruit cherry = new Fruit("Cherry", R.drawable.cherry_pic); 
fruitList.add(cherry); 

Fruit mango = new Fruit("Mango", R.drawable.mango_pic); 
fruitList.add(mango); 


可 以 看 到 ， 
据 。 在 Fruit 类 的 构造 函数 中 将 水 末 的 名 字 和 对 应 的 图 片 id 传 入 ， 然 后 把 创 
建 好 的 对 象 添加 到 水 琳 列 表 中 。 男 外 我 们 使 用 了 一 个 for 循环 将 所 有 的 水 果 


这 里 添加 了 一 个 initFruits() 方法 ， 用 于 初始 化 所 有 的 水 果 数 


数据 添加 了 两 记 ， 这 和 是 因为 如 打 只 添加 一 遇 的 话 ， 数 据 量 还 不 足以 充满 整 


个 屏幕 。 接 着 在 oncreate() 方法 中 创建 了 FruitAdapter 对 象 ， 并 将 
FruitAdapter 作为 适配器 传递 给 ListView， 这 样 定制 ListView 界 面 的 任务 束 


完成 了 。 


现在 重新 运行 程序 ， 殖 果 如 图 3.32 所 示 。 


ListViewTest 


四 人 


图 3.32 定制 界面 的 ListView 运 行 效果 


虽然 目前 我 们 定制 的 界面 还 很 简单 ， 但 是 相信 聪明 的 你 已 经 领情 到 了 诀 
穷 ， 只 要 修改 fruit_item.xml 中 的 内 容 ， 王 可 以 定制 出 各 种 复杂 的 界面 了 。 


3.5.3 ”提升 ListView 的 运行 效率 


之 所 以 说 ListView 这 个 控件 很 难 用 ， 束 是 因为 它 有 很 多 细节 可 以 优化 ， 其 中 
运行 效率 束 是 很 重要 的 一 点 。 目前 我 们 ListView 的 运行 效率 是 很 低 的 ， 因 为 
在 FruitAdapter 的 getview() 方法 中 ， 每 次 都 将 布局 重 靳 加 载 了 一 所 ， 当 
ListView 快 速 滚 动 的 时 候 ， 这 吏 会 成 为 性 能 的 瓶颈 。 

仔细 观察 会 发 现 ，getview() 方法 中 还 有 一 个 convertview 参数 ， 这 个 参数 


用 于 将 之 前 加 载 好 的 布局 进行 缓存 ， 以 便 之 后 可 以 进行 重用 。 修 改 
FruitAdapter 中 的 代码 ， 如 下 所 示 : 


public class FruitAdapter extends ArrayAdapter<Fruit> { 


Q@Override 

public View getView(int position, View convertView, ViewGroup parent) { 
Fruit fruit = getIitem(position); 
View view; 


if (convertView == null) { 
view = LayoutIinflater.from(getContext()).inflate(resourceId, parent, 
false); 
} else { 


View = convertView; 


} 

ImageView fruitImage = (ImageView) view.findViewById(R.id.fruit_ image); 
TextView fruitName = (TextView) view.findViewById(R.id.fruit_name); 
fruitIimage.setImageResource(fruit.getIimageId()); 
fruitName.setText(fruit.getName()); 

return view; 


可 以 看 人 到， 现在 我 们 在 getview( ) 方法 中 进行 了 判断 ， 如 果 convertview 为 


null ， 则 使 用 LayoutInflater 去 加 载 布局 ， 如 果 不 为 nu1ll 则 直接 对 


convertVview 进行 重用 。 这 样 束 大 大 提高 了 ListView 的 运行 效率 ， 在 快速 深 


动 的 时 候 也 可 以 表现 出 更 好 的 性 能 。 


不 过 ， 目 前 我 们 的 这 份 代码 还 是 可 以 继续 优化 的 ， 虽 然 现在 已 经 不 会 再 重 


复 去 加 载 布局 ， 但 是 每 次 在 getview( ) 方法 中 还 是 会 调用 view 的 


findviewById() 方法 来 获取 一 次 控件 的 实例 。 我 们 可 以 借助 一 个 viewHolder 


来 对 这 部 分 性 能 进行 优化 ， 修 改 FruitAdapter 中 的 代码 ， 如 下 所 示 : 


public class FruitAdapter extends ArrayAdapter<Fruit> { 


Q@Override 

public View getView(int position, View convertView, ViewGroup parent) { 
Fruit fruit = getIitem(position); 
View view; 
ViewHolder viewHolder; 


if (convertView == null) { 
view = LayoutIinflater.from(getContext()).inflate(resourceId, parent, 
false); 


ViewHolder = new ViewHolder(); 

viewHolder ,fruitImage = (ImageView) view.findViewById 

(R.id.fruit_image); 

viewHolder.fruitName = (TextView) view.findViewById (R.id.fruit_name); 

view.setTag(viewHolder); // 将 ViewHolder 存 储 在 View 中 
} else { 

View = convertView; 

viewHolder = (ViewHolder) view.getTag(); // 重新 获取 ViewHolder 


} 


viewHolder .fruitImage.setImageResource(fruit.getIimageId()); 
viewHolder .fruitName.setText(fruit.getName()); 
return view; 


} 
class ViewHolder { 
ImageView fruitImage; 


TextView fruitName; 


我 们 新 增 了 一 个 内 部 类 Viewholder ， 用 于 对 控件 的 实例 进行 缓 在 。 当 
convertView 为 null 的 时 候 ， 创 建 一 个 viewHolder 对 象 ， i 
存放 在 viewHolder 里 ， 然 后 调用 view 的 setTag() 方法 ， 将 viewHolder 对 象 
存储 在 view 中 。 当 convertview 不 为 null 的 时 候 ， 则 调用 view 的 getTag() 
方法 ， 把 viewHolder 0 这 样 所 有 控件 的 实例 都 缓存 在 了 viewHolder 


里 ， 就 没有 必要 每 次 都 通过 findviewById() 方法 来 获取 控件 实例 了 。 
这 两 步 优 化 之 后 ， 我 们 ListView 的 运行 效率 就 已 经 非常 不 错 了 


3.5.4 ”ListView 的 点 击 事件 


话说 回来 ，ListView 的 滚动 毕竟 只 是 满足 了 我 们 视觉 上 的 效果 ， 可 是 如 果 
ListView 中 的 子 项 不 能 点 击 的 话 ， 这 个 控件 就 没有 什么 实际 的 用 途 了 。 因 
此 ， 本 小 节 我 们 就 来 学 习 一 下 ListView 如 何 才能 响应 用 户 的 点 击 事件 。 


修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private List<Fruit> fruitList = new ArrayList<>(); 


QOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
initFruits(); 
FruitAdapter adapter = new FruitAdapter(MainActivity.this, R.]Jlayout. 
fruit_item, fruitList); 
ListView listView = (ListView) findViewById(R.id.]1ist view); 
listView,.setAdapter(adapter); 
listView,.setOnItemClickListener(new AdapterView.OnItemClickListener() { 
Q@Override 
public void onItemClick(AdapterView<?> parent, View view, 
int position, long id) { 
Fruit fruit = fruitList.get(position); 
Toast.makeText (MainActivity.this, fruit.getName(), 
Toast .LENGTH_SHORT) .show( ); 


可 以 看 到 ， 我 们 使 用 setonItemclickListener() 方法 为 ListView 注 册 了 一 个 
监听 器 ， 当 用 户 点 击 了 ListView 中 的 任何 一 个 子 项 时 ， 就 会 回调 
onItemClick() 方法 * 在 这 个 方法 中 可 以 通过 position 参数 判断 出 用 户 点 击 
的 是 哪 一 个 子 项 ， 然 后 获取 到 相应 的 水 果 ， 并 通过 Toast 将 水 果 的 名 字 显 示 
出 六 及 


重新 运行 程序 ， 并 点 击 一 下 权 子 ， 效 有 果 如 图 3.33 所 示 。 


ListViewTest 


图 3.33 ”点击 ListView 的 效果 


3.6 ”更 强大 的 滚动 控件 一 一 
RecyclerView 


ListView 由 于 其 强大 的 功能 ， 在 过 去 的 Android 开 发 当中 可 以 说 是 页 献上 日 
越 ， 直 到 今天 仍然 还 有 不 计 其 数 的 程序 在 继续 使 用 着 ListView。 不 过 
ListView 并 不 是 完全 没有 缺点 的 ， 比 如 说 如 果 我 们 不 使 用 一 些 技巧 来 提升 它 
的 运行 效率 ， 那 么 ListView 的 性 能 束 会 非常 差 。 还 有 ，ListView 的 扩展 性 也 
不 够 好 ， 它 只 能 实现 数据 纵 同 滚动 的 效果 ， 如 果 我 们 想 实 现 横 问 深 动 的 
话 ，ListView 是 做 不 到 的 。 


为 此 ，Android 提 供 了 一 个 更 强大 的 滚动 控件 一 RecyclerView。 它 可 以 说 
是 一 个 增强 版 的 ListView， 不 仅 可 以 轻松 实现 和 ListView 同 样 的 效 打 ， 还 优 
化 了 ListView 中 存在 的 各 种 不 足 之 处 。 目 前 Android 官 方 更 加 推荐 使 用 
RecyclerView， 未 来 也 会 有 更 多 的 程序 逐渐 从 ListView 转 向 RecyclerView， 
那么 本 节 我 们 就 来 详细 讲解 一 下 RecyclerView 的 用 法 。 


首先 新 建 一 个 RecyclerViewTest 项 目 ， 并 让 Android Studio 目 动 帮 有 我 们 创建 好 
活动 。 
3.6.1 ”RecyclerView 的 基本 用 法 


和 百分比 布局 类 似 ，RecyclerView 也 属于 新 增 的 控件 ， 为 了 让 RecyclerView 
在 所 有 Android 版 本 上 都 能 使 用 ，Android 团 队 采 取 了 同样 的 方式 ， 将 
RecyclerView 定 义 在 了 support 库 当中 。 因 此 ， 想 要 使 用 RecyclerView 这 个 控 
件 ， 首 先 需要 在 项 目的 build.gradle 中 添加 相应 的 依赖 库 才 行 8 


打开 app/build.gradle 文 件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android.support:appcompat-v7:24.2.1' 
compile 'com.android.support:recyclerview-v7:24.2.1' 
testCompile 'junit:junit:4.12"' 


} 


添加 完 之 后 记得 要 点 击 一 下 Sync Now 来 进行 同步 。 然 后 修改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.v7.widget.RecyclerView 
android:id="@+id/recycler_view" 


android:layout_width="match_parent" 
android:layout_height="match_parent" /> 


</LinearLayout> 


在 布局 中 加 入 RecyclerView 探 件 也 是 非常 简单 的 ， 先 为 RecyclerView 指 定 一 

个 id， 然后 将 守 度 和 珊 度 痢 设 置 为 match_ parent ， 这 样 RecyclerView 也 就 占 
满 了 整个 布局 的 空间 。 需 要 注意 的 是 ， 由 于 RecyclerView 并 不 是 内 置 在 系统 
SDK 当 中 的 ， 所 以 需 ;要 把 完整 的 包 路 径 写 出 来 。 


这 里 我 们 想 要 使 用 RecyclerView 来 实现 和 ListView 相 同 的 效果 ， 因 此 就 需要 
准备 一 份 同样 的 水 果 图 片 。 人 简单 起 见 ， 我 们 就 直接 从 ListViewTest 项 目 中 把 
图 片 复 制 过 来 就 可 以 了 ， 男 外 顺便 将 Fruit 类 和 fruit_item.xml 也 复制 过 来 ， 
省 得 将 同样 的 代码 再 写 一 过 。 


接 下 来 需要 为 RecyclerView; 准 备 一 个 适配器 ， 新 建 FruitAdapter 类 ， 让 这 个 
适配器 继承 自 Recyclerview.Adapter ， 并 将 泛 型 指定 为 
FruitAdapter .ViewHolder ° 其 中 ，vViewHolder 是 我 们 在 FruitAdapter 中 定 


义 的 一 个 内 部 类 ， 代 码 如 下 所 示 : 


public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> { 


private List<Fruit> mFruitList; 


static class ViewHolder extends RecyclerView.ViewHolder { 
ImageView fruitImage; 
TextView fruitName; 


public ViewHolder(View view) { 
super (view); 
fruitImage = (ImageView) view.findViewById(R.id.fruit_ image); 
fruitName = (TextView) view.findViewById(R.id.fruit_name); 
} 
= 


public FruitAdapter(List<Fruit> fruitList) { 
mFruitList = fruitList; 
} 


QOverride 
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { 
View view = LayoutInflater.from(parent .getContext()) 
.inflate(R.layout.fruit_item, parent, false); 
ViewHolder holder = new ViewHolder (view); 
return holder; 


} 


Q@Override 

public void onBindViewHolder(ViewHolder holder, int position) { 
Fruit fruit = mFruitList.get(position); 
holder .fruitIimage.setImageResource(fruit.getIimageId()); 
holder .fruitName.setText(fruit.getName()); 

} 


Q@Override 
public int getItemCount() { 
return mFruitList.size(); 


虽然 这 段 代 码 看 上 去 好 像 有 点 长 ， 但 其 实 它 比 ListView 的 适 配 絮 要 更 容易 理 
解 。 这 里 我 们 首先 定义 了 一 个 内 部 类 ViewHolder ， 人 要 继承 目 
RecyclerView.ViewHolder ° 然后 viewHolder 的 构造 函数 中 要 传 入 一 个 View 


参数 ， 这 个 参数 通常 就 是 RecyclerView 子 项 的 最 外 层 布局 ， 那 么 我 们 束 可 以 
通过 findviewById() 方法 来 获取 到 布局 中 的 ImageView 和 TextView 的 实例 
下 O 


个 构造 函数 ， 这 个 方法 用 于 把 要 展示 
的 数据 源 传 进 来 ， 并 赋值 给 一 个 全 局 变量 mFruitList ， 我 们 后 续 的 操作 都 
将 在 这 个 数据 源 的 基础 上 进 行 。 


继续 往 下 看 ， 由 于 FruitAdapter 是 继承 自 Recyclerview. Adapter 的 ， 那么 吏 
必须 重 写 oncreateviewHolder() 、 onBindViewHolder() 和 和 getItemcount()i 这 
3 个 方法 。oncreateviewHolder( ) 方法 是 用 于 创建 viewHolder 实例 的 ， 我 们 
在 这 个 方法 中 将 fruit_itenm 布局 加 载 进 来 ， 然 后 创建 一 个 viewHolder 实 

例 ， 并 把 加 载 出 来 的 布局 传 入 到 构造 函数 当中 ， 最 后 将 viewHolder 的 实例 
返回 。onBindviewHolder() 方法 是 用 于 对 RecyclerView 子 项 的 数据 进行 赋值 
的 ， 会 在 每 个 子 项 被 次 动 到 屏 医 内 的 时 候 执 行 ， 这 里 我 们 通过 position 参 
数 得 到 当前 项 的 Fruit 实例 ， 然 后 再 将 数据 设置 到 viewHolder 的 ImageView 
和 TextView 当 中 即 可 。getItemcount() 方法 就 非常 简单 了 ， 它 用 于 告诉 
RecyclerView 一 共有 多 少子 项 ， 直 接 返 回 数据 源 的 长 度 束 可 以 了 。 


适配器 准备 好 了 之 后 ， 我 们 就 可 以 开始 使 用 RecyclerView 了 了， 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private List<Fruit> fruitList = new ArrayList<>()， 


Q@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
initFruits(); // 初始 化 水 果 数 据 
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view); 
LinearLayoutManager layoutManager = new LinearLayoutManager(this),; 
recyclerView.setLayoutManager (layoutManager); 
FruitAdapter adapter = new FruitAdapter(fruitList); 
recyclerView.setAdapter (adapter ) ， 


} 


private void initFruits() { 
for (int i = 0; i < 2; i++) { 

Fruit apple = new Fruit("Apple", R.drawable.apple_pic); 
fruitList.add(apple); 
Fruit banana = new Fruit("Banana", R.drawable.banana pic); 
fruitList.add(banana); 
Fruit orange = new Fruit("Orange", R.drawable.orange pic); 
fruitList.add(orange); 
Fruit watermelon = new Fruit("wWatermelon", R.drawable.watermelon_pic); 
fruitList.add(watermelon); 
Fruit pear = new Fruit("Pear", R.drawable.pear_pic); 
fruitList.add(pear); 
Fruit grape = new Fruit("Grape", R.drawable.grape_pic); 
fruitList.add(grape); 
Fruit pineapple = new Fruit("Pineapple", R.drawable.pineapple_pic); 
fruitList.add(pineapple); 
Fruit strawberry = new Fruit("Strawberry", R.drawable.strawberry_pic); 
fruitList.add(strawberry); 
Fruit cherry = new Fruit("Cherry", R.drawable.cherry_pic); 
fruitList.add(cherry); 
Fruit mango = new Fruit("Mango", R.drawable.mango_pic); 
fruitList.add(mango); 


可 以 看 到 ， 这 里 使 用 了 一 个 同样 的 initFruits() 方法 ， 
水 果 数 据 。 接 着 在 oncreate( ) 方法 中 我 们 先 获 取 到 RecyclerView 的 实例 ， 然 
后 创建 了 一 个 LinearLayoutManager 对 象 ， 并 将 它 设置 到 RecyclerView 当 


中 。LayoutManager 用 yw tne 方式 ;这 里 使 用 鸭 
LinearLayoutManager 是 线性 布局 的 意思 ， 可 以 实现 和 ListView 类 似 的 效果 。 
接 下 来 我 们 创建 了 FruitAdapter 的 实例 ， 并 将 水 有 果 数 据 传 入 到 FruitAdapter 
的 构造 画 数 中 ， 最 后 调用 RecyclerView 的 setAdapter() 方法 来 完成 适 配 妖 设 
置 ， 这 样 RecyclerView 和 数据 之 间 的 天 联 就 建立 完成 了 。 


现在 可 以 运行 一 下 程序 了 ， 效 果 如 图 3.34 所 示 。 


RecyclerViewTest 


人 


图 3.34 RecyclerView 运 行 效果 


可 以 看 到 ， 我 们 使 用 RecyclerView 实 现 了 和 ListView 儿 平一 模 一 样 的 效果 ， 
虽说 在 代码 量 方面 并 没有 明显 地 减少 ， 但 是 逻辑 变 得 更 加 清晰 了 。 当 然 这 
只 是 RecydlerView 的 基本 用 法 而 已 ， 接 下 来 我 们 就 看 一 看 RecyclerView 还 能 
实现 哪些 ListView 实 现 不 了 的 效果 。 


3.6.2 ”实现 横 癌 滚动 和 瀑布 流 布局 


我 们 已 经 知道 ，ListView 的 扩展 性 并 不 好 ， 它 只 能 实现 纵 辣 滚动 的 效果 ， 如 
果 想 进行 横 癌 滚动 的 话 ，ListView 束 做 不 到 了 。 那 么 RecyclerView 束 能 做 得 
到 吗 ? 当然 可 以 ， 不 仅 能 做 得 到 ， 还 非常 和 兴 单 ， 那 么 接 下 来 我 们 融和 尝试 实 
现 一 下 横向 滚动 的 效果 。 


首先 要 对 fruit_item 布局 进行 修改 ， 因 为 目前 这 个 布局 里 面 的 元 素 是 水 平 
排列 的 ， 适 用 于 纵 回 滚动 的 场景 ， 而 如 采 我 们 要 实现 横 回 滚动 的 话 ， 应 该 


把 fruit_item 里 的 元 素 改 成 牌 直 排列 才 比 较 合 理 。 修 改 fruit_item.xml 中 的 代 
码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="100dp" 
android:layout_height="wrap_content" > 


<ImageView 
android:id="@+id/fruit_image" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" /> 


<TextView 
android:id="@+id/fruit_name" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" 
android:layout_marginTop="1i0dp" /> 


</LinearLayout> 


可 以 看 到 ， 我 们 将 LinearLayout 改 成 垂直 方向 排列 ， 并 把 宽度 设 为 100dp。 


这 里 将 宽度 指定 为 固定 值 是 因为 每 种 水 果 的 文字 长 度 不 一 致 ， 如 果 用 
wrap_content 的 话 ，RecyclerView 的 子 项 就 会 有 长 有 短 ， 非 常 不 美观 ， 而 如 
果 用 match_parent 的 话 ， 就 会 导致 宽度 过 长 ， 一 个 子 项 占 满 整个 屏幕 。 


然后 我 们 将 ImageView 和 TextView 都 设置 成 了 在 布局 中 水 平 居 中 ， 并 且 使 用 
layout_marginTop 属性 让 文字 和 图 片 之 间 保持 一 些 距 离 。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private List<Fruit> fruitList = new ArrayList<>()， 


Q@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedIinstanceState); 
setcontentView(R.1layout.activity_main); 
initFruits(); 
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view); 
LinearLayoutManager layoutManager = new LinearLayoutManager(this),; 
lJayoutManager .setOrientation(LinearLayoutManager .HORIZONTAL); 
recyclerView.setLayoutManager (layoutManager); 
FruitAdapter adapter = new FruitAdapter(fruitList); 
recyclerView.setAdapter (adapter ) ， 


| 


MainActivity 中 只 加 入 了 一 行 代码 ， 调 用 LinearLayoutManager 的 
setorientation() 方法 来 设置 布局 的 排列 方向 ， 默 认 是 纵 癌 排列 的 ， 我 们 
传 入 LinearLayoutManager .HORIZONTAL 表示 让 布局 横行 排列 ， 这 样 
RecyclerView 就 可 以 横 癌 滚动 了 。 


重新 运行 一 下 程序 ， 效 有 果 如 图 3.35 所 示 。 


RecyclerViewTest 


图 3.35 ”横向 RecyclerView 效 果 
你 可 以 用 手指 在 水 平方 向 上 请 动 来 查看 屏幕 外 的 数据 。 
为 什么 ListView 很 难 或 者 根本 无 法 实现 的 效 采 在 RecyclerView 上 这 么 轻松 就 


能 实现 了 呢 ? 这 主要 得 益 于 RecyclerView 出 色 的 设计 。ListView 的 布局 排列 
是 由 目 身 去 管理 的 ， 而 RecyclerView 则 将 这 个 工作 交 给 了 LayoutManager， 


LayoutManager 中 制定 了 一 套 可 扩展 的 布局 排列 接口 ， 子 类 只 要 按照 接口 的 
规范 来 实现 ， 就 能 定制 出 各 种 不 同 排列 方式 的 布局 了 。 


除了 LinearLayoutManager 之 外 ，RecyclerView 还 给 我 们 提供 了 

GridLayoutManager 和 StaggeredGridLayoutManager 这 两 种 内 置 的 布局 排列 方 

式 。GridLayoutManager 可 以 用 于 实现 网 格 布局 ， 

StaggeredGridLayoutManager 可 以 用 于 实现 瀑布 流 布 局 。 这 里 我 们 来 实现 一 

ga 流 布 局 ， 网 格 布 局 束 作 为 课 后 习题 ， 交 给 你 目 己 来 
究 了 。 


首先 还 是 来 修改 一 下 fruit_item.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height=" wrap_content" 
android:layout_margin="5dp" > 


<ImageView 
android:id="@+id/fruit_image" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" /> 


<TextView 
android:id="@+id/fruit_name" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="]eft" 
android:layout_marginTop="1i0dp" /> 


</LinearLayout> 


这 里 做 了 几 处 小 的 调整 ， 首 先 将 LinearLayout 的 宽度 由 100dp 改 成 了 
match_parent ， 因 为 瀑布 流 布 局 的 视 度 应 该 是 根据 布局 的 列 数 来 目 动 适 配 
的 ， 而 不 是 一 个 固定 值 。 另 外 我 们 使 用 了 layout_margin 属性 来 让 子 项 之 间 
互 留 一 点 间距 ， 这 样 就 不 至 于 所 有 子 项 都 紧 贴 在 一 些 。 还 有 就 是 将 TextView 
的 对 齐 属性 改 成 了 居 左 对 齐 ， 因 为 待 会 我 们 会 将 文字 的 长 度 变 长 ， 如 果 还 
是 居中 显示 就 会 感觉 区 怪 的 。 


接着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private List<Fruit> fruitList = new ArrayList<>(); 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 


Super .onCreate(SavedInstanceState ) 

setcontentView(R.1layout.activity_main); 

initFruits(); 

RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view); 
StaggeredGridLayoutManager layoutManager = new 

StaggeredGridLayoutManager(3, StaggeredGridLayoutManager .VERTICAL ); 
recyclerView.setLayoutManager (layoutManager); 

FruitAdapter adapter = new FruitAdapter(fruitList); 
recyclerView.setAdapter (adapter ); 


} 


private void initFruits() { 
for (int i = 0; i < 2; i++) { 
Fruit apple = new Fruit( 
getRandomLengthName("Apple"), R.drawable.apple_pic); 
fruitList.add(apple); 
Fruit banana = new Fruit( 
getRandomLengthName("Banana"), R.drawable.banana_ pic); 
fruitList.add(banana); 
Fruit orange = new Fruit( 
getRandomLengthName("Orange"), R.drawable.orange_ pic); 
fruitList.add(orange); 
Fruit watermelon = new Fruit( 
getRandomLengthName("Watermelon"), R.drawable.watermelon_ pic); 
fruitList.add(watermelon); 
Fruit pear = new Fruit( 
getRandomLengthName("Pear"), R.drawable.pear_pic); 
fruitList.add(pear); 
Fruit grape = new Fruit( 
getRandomLengthName("Grape"), R.drawable.grape_pic); 
fruitList.add(grape); 
Fruit pineapple = new Fruit( 
getRandomLengthName("Pineapple"), R.drawable.pineapple_pic); 
fruitList.add(pineapple); 
Fruit strawberry = new Fruit( 
getRandomLengthName("Strawberry"), R.drawable.strawberry_pic); 
fruitList.add(strawberry); 
Fruit cherry = new Fruit( 
getRandomLengthName("Cherry"), R.drawable.cherry_pic); 
fruitList.add(cherry); 
Fruit mango = new Fruit( 
getRandomLengthName("Mango"), R.drawable.mango_pic); 
fruitList.add(mango); 


} 


private String getRandomLengthName(String name) { 
Random random = new Random( ); 
int length = random.nextInt(20) + 1; 
StringBuilder builder = new StringBuilder(); 
for (int i = 0; i < length; i++) { 
builder .append(name); 
} 


return builder.toString(); 


首先 ， 在 oncreate() 方法 中 ， 我 们 创建 了 一 人 Staggeredel Ld avantNanayger 
的 实例 。staggeredGridLayoutManager 的 构造 辑 数 接收 两 个 参数 ， 第 一 个 参 


数 用 于 指定 布局 的 列 数 ， 传 入 3 表示 会 把 布局 分 为 3 列 ; 第 二 个 参数 用 于 指 
定 布 局 的 排列 方向 ， 传 入 staggeredGridLayoutManager .VERTICAL 表示 会 让 
布局 纵 回 排列 ， 最 后 再 把 创建 好 的 实例 设置 到 RecyclerView 当 中 就 可 以 了 ， 
就 是 这 人 么 简单 ! 


没 错 ， 仅 仅 修改 了 一 行 代码 ， 我 们 残 已 经 成 功 实现 瀑布 流 布局 的 效 采 了。 
不 过 由 于 瀑布 流 布 局 需要 各 个 子 项 的 高 度 不 一 致 才能 看 出 明显 的 效果 ， 为 
此 我 又 使 用 了 一 个 小 技巧 。 这 里 我 们 把 眼光 聚焦 在 getRandomLengthName() 
这 个 方法 上 ， 这 个 方法 使 用 了 Random 对 象 来 创造 一 个 1 到 20 之 间 的 随机 数 ， 
然后 将 参数 中 传 入 的 字符 串 随 机 重复 儿 遍 。 在 initFruits() 方法 中 ， 每 个 
水 果 的 名 字 都 改 成 调用 getRandomLengthName() 这 个 广 法 来 生成 ， 这 样 就 能 
保证 各 水 果 名 字 的 长 短 差 距 都 比较 大 ， 子 项 的 高 度 也 束 各 不 相同 了 。 


现在 重新 运行 一 下 程序 ， 效 果 如 图 3.36 所 示 。 


RecyclerViewTest 


图 3.36 瀑布 流 布局 效果 


当然 由 于 水 果 名 字 的 长 度 每 次 都 是 随机 生成 的 ， 你 运行 时 的 效果 肯定 和 图 
中 还 是 不 一 样 的 。 


3.6.3 ”RecyclerView 的 点 击 事件 


和 ListView 一 样 ，RecyclerView 也 必须 要 能 响应 点 击 事件 才 可 以 ， 不然 的 话 
就 没什么 实际 用 途 了 。 不 过 不 同 于 ListView 的 是 ， RecyclerView 并 没有 提供 
类 似 于 setonItemclickListener() 这 样 的 注册 监听 器 方法 ， 而 是 需要 我 们 上 自 
己 给 子 项 具体 的 View 去 注册 点 击 事件 ， 相 比 于 ListView 来 说 ， 实 现 起 来 要 复 


杂 一 些 。 


那么 你 可 能 就 有 疑问 了 ， 为 什么 RecyclerView 在 各 方面 的 设计 都 要 优 于 
ListView， 偏 偏 在 点 击 事件 上 却 没 有 处 理 得 非常 好 呢 ? 其 实 不 是 这 样 的 ， 
ListView 在 点 击 事件 上 的 处 理 并 不 人 性 化 ， setOonItemClickListener() 方法 
注册 的 是 子 项 的 点 击 事件 ， 但 如 全 我 二 点 击 的 征 于 项 里 具体 的 从 一个 投 二 
呢 ? 虽然 ListView 也 是 能 做 到 的 ， 但 是 实现 起 来 就 相对 比较 硫 顷 了 。 为 此 ， 
RecyclerView 干 脆 直 接 据 痉 了 子 项 点 击 事件 的 监听 器 ， 所 有 的 点 击 事件 都 由 
具体 的 View 去 注册 ， 就 再 没有 这 个 困扰 了。 


下 面 我 们 来 具体 学 习 一 下 如 何在 RecyclerView 中 注册 点 击 事件 ， 修 改 
FruitAdapter 中 的 代码 ， 如 下 所 示 : 


public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> { 


private List<Fruit> mFruitList; 


static class ViewHolder extends RecyclerView.ViewHolder { 
View fruitView; 
ImageView fruitImage; 
TextView fruitName; 


public ViewHolder(View view) { 
super (view); 
fruitView = view; 
fruitImage = (ImageView) view.findViewById(R.id.fruit image); 
fruitName = (TextView) view.findViewById(R.id.fruit_name); 
} 
+ 


public FruitAdapter(List<Fruit> fruitList) { 
mFruitList = fruitList; 


} 


QOverride 
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { 
View view = LayoutInflater.from(parent .getContext( )) ,inflate(R. Layout , 
fruit_item, parent, false); 
final ViewHolder holder = new ViewHolder (view); 
holder .fruitView.setOoncClickListener(new View.OnClickListener() { 
Q@Override 


public void onClick(View v) { 
int position = holder.getAdapterPosition(); 
Fruit fruit = mFruitList.get(position); 
Toast.makeText(v.getContext(), "you clicked view "+ fruit.getName(), 
Toast .LENGTH_SHORT) .show( ); 
} 
}); 
holder .fruitImage.setOonClickListener(new View.OnclickListener() { 
@Override 
public void onClick(View v) { 
int position = holder.getAdapterPosition(); 
Fruit fruit = mFruitList.get(position); 
Toast.makeText(v.getContext(), "you clicked image " + fruit.getName(), 
Toast .LENGTH_SHORT) .show( ); 
} 
}); 


return holder ， 


在 viewHolder 中 添加 了 fruitview 变量 来 保存 


子 项 最 外 层 布局 的 实例 ， 然 后 在 oncreateviewHolder() 方法 中 注册 点 击 事件 
束 可 以 了 。 这 里 分 别 为 最 外 层 布局 和 ImageView 都 注册 了 点 击 事件 ， 
RecyclerView 的 强大 之 处 也 在 这 里 ， 它 可 以 轻松 实现 子 项 中 任意 控件 或 布局 
的 点 击 事件 。 我 们 在 两 个 点 击 事 件 中 先 获取 了 用 户 点 击 的 position， 然 后 通 
过 position 拿 到 相应 的 Fruit 实例 ， 再 使 用 Toast 分 别 弹 出 两 种 不 同 的 内 容 以 
示 区 别 。 


现在 重新 运行 代码 ， 并 点 击 香 震 的 图 片 部 分 ， 殖 果 如 图 3.37 所 示 。 可 以 看 
到 ， 这 时 触发 了 ImageView 的 点 击 事件 。 
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图 3.37 点击 香 营 的 图 片 部 分 


然后 再 点 击 菠萝 的 文字 部 分 ， 由 于 TextView 并 没有 注册 点 击 事件 ， 因 此 点 击 
文字 这 个 事件 会 被 子 项 的 最 外 层 布局 捕获 到 ， 效 果 如 图 3.38 所 示 。 
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图 3.38 ” 扣 击 菠萝 的 文字 部 分 


3.7 ”编写 界面 的 最 佳 实践 


既然 已 经 学 习 了 那么 多 UI 开 发 的 知识 ， 也 是 时 候 实 战 一 下 了 。 这 次 我 们 要 
综合 运用 前 面 所 学 的 大 量 内 容 来 编写 出 一 个 较为 复杂 且 相 当 美 观 的 聊天 界 
面 ， 你 准备 好 了 吗 ? 要 先 创建 一 个 UIBestPractice 项 目 才 算 准 备 好 了 哦 。 


3.7.1 ”制作 Nine-Patch 图 片 

在 实战 正式 开始 之 前 ， 我 们 还 需要 先 学 习 一 下 如 何 制作 Nine-Patch 图 片 。 你 
可 能 之 前 还 没有 听 说 过 这 个 名 词 ， 它 是 一 种 被 特殊 处 理 过 的 png 图 片 ， 能 够 
指定 哪些 区 域 可 以 被 拉 伸 、 哪 些 区 域 不 可 以 。 


那么 Nine-Patch 图 厂 到 底 有 什么 实际 作用 呢 ? 我们 还 是 通过 一 个 例子 来 看 
下 吧 。 比 如 说 项 目 中 有 一 张 气泡 样式 的 图 片 message_left.png， 如 图 3.39 所 


图 3.39 气泡 样式 图 片 


我 们 将 这 张 图 片 设置 为 LinearLayout 的 背景 图 片 ， 修 改 activity_main.xml 中 的 
代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:background="@drawable/message_left" 


> 
</LinearLayout> 


将 LinearLayout 的 宽度 指定 为 natch_parent ， 然 后 将 它 的 背景 图 设置 为 
message_left ， 现 在 运行 程序 ， 效 果 如 图 3.40 所 示 。 
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图 3.40 气泡 被 均匀 拉 伸 的 效果 


可 以 看 到 ， 由 于 message_left 的 宽度 不 足以 填 满 整个 屏幕 的 宽度 ， 整 张 图 
片 被 均匀 地 拉 伸 了 ! 这 种 效果 非常 差 ， 用 户 肯 定 是 不 能 容忍 的 ， 这 时 我 们 
就 可 以 使 用 Nine-Patch 图 片 来 进行 改善 。 


在 Android sdk 目 好 下 有 一 个 tools 文 件 来， 在 这 个 文件 夹 中 找到 
draw9patch.bat 文 件 ， 我 们 就 是 使 用 它 来 制作 Nine-Patch 图 片 的 。 不 过 ， 要 打 
开 这 个 文件 ， 必 须 先 将 JDK 的 bin 目 录 配 置 到 环境 变量 当中 才 行 ， 比 如 你 使 
用 的 是 Android Studio 内 置 的 jdk， 那 么 要 配置 的 路 径 束 是 <Android Studio 安 
闭 目 录 >/jre/bin。 如 有 果 你 还 不 知道 该 如 何 配 置 环境 变量 ， 可 以 先 去 参考 6.4.1 
小 和 的 内 容 。 


双击 打开 draw9patch.bat 文 件 ， 在 导航 栏 点 击 File ~ Open 9-patch 将 
message_left.png 加 载 进 来 ， 如 图 3.41 所 示 。 
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图 3.41 使 用 draw9patch 编 辑 message_left 图 片 


我 们 可 以 在 图 片 的 四 个 边框 绘制 一 个 个 的 小 黑 点 ， 在 上 边框 和 左边 框 绘制 
的 部 分 表示 当 图 片 需要 拉 伸 时 就 拉 伸 黑 点 标记 的 区 域 ， 在 下 边框 和 右边 杠 
绘制 的 部 分 表示 内 容 会 被 放置 的 区 域 。 使 用 鼠标 在 图 片 的 边缘 拖 动 就 可 以 
进行 绘制 了 ， 按 住 Shift 键 拖 动 可 以 进行 擦 除 。 绘 制 完成 后 效果 如 图 3.42 所 
不 ° 
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图 3.42 绘制 完成 后 的 message_left 图 片 
最 后 点 击 导 航 栏 File -> Save 9-patch 把 绘制 好 的 图 片 进行 保存 ， 此 时 的 文件 名 


就 是 message_left.9.png。 使 用 这 张 图 片 替 换 掉 之 前 的 message_left.png 图 片 ， 
重新 运行 程序 ， 效 果 如 图 3.43 所 示 。 
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图 3.43 气泡 只 拉 伸 绘制 区 域 的 效果 


这 样 当 图 片 需要 拉 伸 的 时 候 ， 就 可 以 只 拉 伸 指 定 的 区 域 ， 程 序 在 外 观 上 也 
有 了 很 大 的 改进 。 有 了 这 个 知识 储备 之 后 ， 我 们 就 可 以 进入 实战 环节 了 。 


3.7.2 ”编写 精美 的 聊天 界面 


既然 是 要 编写 一 个 聊天 界面 ， 那 束 肯 定 要 有 收 到 的 消 恩 和 发 出 的 消息 。 上 
一 世 中 我 们 制作 的 message_left.9.png 可 以 作为 收 到 消息 的 背景 图 ， 那 么 毫 无 
疑问 你 还 需要 再 制作 一 张 message_right.9.png 作 为 发 出 消息 的 背景 


图 厂 都 提供 好 了 之 后 就 可 以 开始 编码 了 。 由 于 待 会 我 们 会 用 到 
RecyclerView, 因此 首先 需要 在 app/build.gradle 当 中 添加 依赖 库 ， 如 下 所 
人 小 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android.support:appcompat-v7:24.2.1" 
compile 'com.android.support:recyclerview-v7:24.2.1' 


testCompile "junit:jJjunit:4.12 


接 下 来 开始 编写 主 界面 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="#d8e0Qe8" > 


<android,.support.v7.widget.RecyclerView 
android:id="@+id/msg_recycler_view" 
android:layout_width="match_parent" 
android:layout_height="QOdp" 
android:layout_weight="1" /> 


<LinearLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content" > 


<EditText 
android:id="@+id/input_text" 
android:layout_width="QOdp" 
android:layout_height="wrap_content" 
android:layout_ weight="1" 
android:hint="Type something here" 
android:maxLines="2" /> 


<Button 
android:id="@+id/send" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="Send" /> 


</LinearLayout> 


</LinearLayout> 


我 们 在 主 界 面 中 放置 了 一 个 RecyclerView 用 于 显示 聊天 的 消息 内 容 ， 又 放置 
了 一 个 EditText 用 于 输入 消息 ， 还 放置 了 一 个 Button 用 于 发 送 消息 。 这 里 用 
到 的 所 有 属性 都 是 我 们 之 前 学 过 的 ， 相 信 你 理解 起 来 应 该 不 费力 。 


然后 定义 消 乱 的 实体 类 ， 新 建 Msg ， 代 码 如 下 所 示 : 


public class Msg { 


public static final int TYPE_RECEIVED = 0; 
public static final int TYPE_SENT = 1; 


private String content 


private int type; 


public Msg(String content, int type) { 
this.content = content,; 
this.type = type; 

} 


public String getContent() { 
return content; 
} 


public int getType() { 
return type; 
} 


Msg 类 中 只 有 两 个 字段 ，content 表示 消息 的 内 容 ，type 表示 消息 的 类 型 。 
其 中 消息 类 型 有 两 个 值 可 选 ，TYPE_RECEIVED 表示 这 是 一 条 收 到 的 消息 ， 


TYPE_SENT 表示 这 是 一 条 发 出 的 消息 。 


返 帮 来 编写 RecyclerView 子 项 的 布局 ， 新 建 msg_item.xm]l， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:padding="10dp" > 


<LinearLayout 
android:id="@+id/left_layout" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="]eft" 
android:background="@drawable/message_left" > 


<TextView 
android:id="@+id/left_msg" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:layout_margin="10dp" 
android:textcolor="#fff" /> 


</LinearLayout> 


<LinearLayout 
android:id="@+id/right_layout" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="right" 
android:background="@drawable/message_right" > 


<TextView 
android:id="@+id/right_msg" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 


android:layout_margin="10dp" /> 
</LinearLayout> 


</LinearLayout> 


这 里 我 们 让 收 到 的 请 妃 居 左 对 齐 ， 发 出 的 消息 居 右 对 齐 ， 并 且 分 别 使 用 
left.9.png 和 message_right.9.png 作 为 背景 图 。 你 可 能 会 有 些 疑 虑 ， 
各 么 能 让 收 到 的 消息 和 发 出 的 消息 都 放 在 同一 个 布局 里 呢 ? 不 用 担心 ， 还 


记得 我 们 前 面 学 过 的 可 见 属性 吗 ? 只 要 稍 后 在 代码 中 根据 消 居 的 类 型 来 决 
定 隐 藏 和 显示 哪 种 消息 就 可 以 了 。 


接 下 来 需要 创建 RecyclerView 的 适配器 类 ， 新 建 类 MsgAdapter ， 代 码 如 下 所 
示 : 


public class MsgAdapter extends RecyclerView.Adapter<MsgAdapter .ViewHolder> { 
private List<Msg> mMsgList; 
static class ViewHolder extends RecyclerView.ViewHolder { 
LinearLayout leftLayout,; 
LinearLayout rightLayout,; 
TextView leftMsg; 
TextView rightMsg; 


public ViewHolder(View view) { 
super (view); 
leftLayout = (LinearLayout) view,.findViewById(R.id.]left_layout); 
rightLayout = (LinearLayout) view.findViewById(R.id.right_layout); 
leftMsg = (TextView) view.findViewById(R.id,.]left_msg); 
rightMsg = (TextView) view.findViewById(R.id.right_msg); 


} 


public MsgAdapter(List<Msg> msgList) { 
mMsgList = msgList; 
} 


QOverride 
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { 
View view = LayoutInflater.from(parent.getContext()).inflate 
(R.layout.msg_item, parent, false); 
return new ViewHolder (view); 


} 


Q@Override 
public void onBindViewHolder(ViewHolder holder, int position) { 
Msg msg = mMsgList.get(position); 
if (msg.getType() == Msg.TYPE_RECEIVED) { 
// 如 果 是 收 到 的 消息 ， 则 显示 左边 的 消息 布局 ， 将 右边 的 消息 布局 隐藏 
holder .leftLayout.setVisibility(View.VISIBLE); 
holder .rightLayout ,SetVisibility(View.GONE) ， 


holder .leftMsg.setText(msg.getContent()); 

} else if(msg.getType() == Msg.TYPE_SENT) { 
// 如 果 是 发 出 的 消息 ， 则 显示 右边 的 消息 布局 ， 将 左边 的 消息 布局 隐藏 
holder .rightLayout ,SetVisibility(View.VISIBLE) ， 
holder.leftLayout.setVisibility(View.GONE); 
holder .rightMsg.setText(msg.getContent()); 


} 


QOverride 

public int getItemCount() { 
return mMsgList.size(); 

} 


以 上 代码 你 应 该 非常 熟悉 了 ， 和 我 们 学 习 RecyclerView 那 一 闻 的 代码 基本 是 
一 样 的 ， a dn 方法 中 增加 了 对 消息 类 型 的 判断 。 


如 琳 这 条 消 居 是 收 到 的 ， 则 显示 左边 的 消 筷 布局 ， 如 果 这 条 消 奶 是 发 出 
的 ， 则 显示 右边 的 消 轧 布局 。 


最 后 修改 MainActivity 中 的 代码 ， 来 为 RecyclerView 初 始 化 一 些 数 据 ， 并 给 
发 送 按钮 加 入 事件 啊 应 ， 代 码 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private List<Msg> msgList = new ArrayList<>(); 
private EditText inputText; 

private Button send; 

private RecyclerView msgRecyclerView; 

private MsgAdapter adapter; 


QOverride 
protected void onCreate(Bundle savedIinstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
initMsgs(); // 初始 化 消息 数据 
inputText = (EditText) findViewById(R.id.input_ text); 
send = (Button) findViewById(R.id.send); 
msgRecyclerView = (RecyclerView) findViewById(R.id.msg_recycler_view); 
LinearLayoutManager layoutManager = new LinearLayoutManager (this); 
msgRecyclerView.setLayoutManager (layoutManager); 
adapter = new MsgAdapter(msgList); 
msgRecyclerView.setAdapter (adapter ) ， 
send.setonClickListener(new View.OnClickListener() { 
@Override 
public void oncClick(View v) { 
String content = inputText.getText().toString(); 
if (!"".equals(content)) { 
Msg msg = new Msg(content, Msg.TYPE_SENT); 
msgList.add(msg); 
adapter.notifyItemInserted(msgList.size() - 1); // 当 有 新 消息 时 ， 


刷新 RecyclerView 中 的 显示 
msgRecyclerView.scrollToPosition(msgList.size() - 1); // 将 
RecyclerView 定 位 到 最 后 一 行 

inputText ,setText(""); // 清空 输入 框 中 的 内 容 


private void initMsgs() { 
Msg msg1 = new Msg("Hello guy.", Msg.TYPE_RECEIVED); 
msgList.add(msg1); 
Msg msg2 = new Msg("Hello. Who is that?", Msg.TYPE_SENT); 
msgList.add(msg2); 
Msg msg3 = new Msg("This is Tom. Nice talking to you. ", Msg.TYPE_RECEIVED); 
msgList.add(msg3); 


在 initMsgs() 方法 中 我 们 先 初 始 化 了 几 条 数据 用 于 在 RecyclerView 中 显示 。 


然后 在 发 送 按钮 的 点 击 事件 里 获取 了 EditText 中 的 内 容 ， 如 果 内 容 不 为 空 字 
符 串 则 创建 出 一 个 新 的 msg 对象， 并 把 它 添加 a 到 msgList 列 表 中 去 。 之 后 又 
调用 了 适配器 的 notifyItemInserted() 方法 ， 用 于 通知 列表 有 新 的 数据 插 
入 ， 这 样 新 增 的 一 条 消息 才能 够 在 RecyclerView 中 显示 。 接 着 调用 
RecyclerView 的 sc rollToPosition() 方法 将 显示 的 数据 定位 到 最 后 一 行 ， 以 
保证 一 定 可 以 看 得 到 最 后 发 出 的 一 条 消息 。 最 后 调用 EditText 的 setText () 
方法 将 输入 的 内 容 清 空 。 


这 样 所 有 的 工作 束 都 完成 了 ， 终 于 可 以 检验 一 下 我 们 的 成 末了 ， 运 行程 序 
之 后 你 将 会 看 到 非常 美观 的 聊天 界面 ， 并 且 可 以 输入 和 发 送 消 恩 ， 如 图 3.44 
Ba 
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This is Tom. Nice talking to you 


图 3.44 精美 的 聊天 界面 


相信 这 个 例子 的 实战 过 程 不 仅 加 深 了 你 对 本 章 中 所 学 UI 知识 的 理解 ， 还 让 
你 有 了 如 何 灵 活 运用 这 些 知 识 来 设计 出 优秀 界面 的 思路 。 这 一 章 也 是 学 了 
不 少 东 西 ， 让 我 们 来 总 结 一 下 吧 。 


3.8 ”小 结 与 扩 评 


虽然 本 章 的 内 容 很 多 ， 但 我 觉得 学 习 起 来 应 该 还 是 挺 愉快 的 吧 。 不 同 于 上 
一 章 中 我 们 来 来 回回 使 用 那 几 个 按钮 ， 本 章 可 以 说 是 使 用 了 各 种 各 样 的 欣 
件 ， 制 作出 了 丰 是 多 彩 的 界面 。 尤 其 十 在 实战 环节 ， 编 写 出 了 那么 精美 的 
聊天 界面 ， 你 的 满足 感应 该 比 上 一 章 还 要 强 吧 ? 


本 章 从 Android 中 的 一 些 常见 控件 开始 入 手 ， 依 次 介绍 了 基本 布局 的 用 法 、 
目 定 义 探 件 的 方法 、ListView 的 详细 用 法 以 及 RecyclerView 的 使 用 ， 基 本 已 
经 将 重要 的 UI 知 识 点 全 部 覆盖 了 。 想 想 在 开始 的 时 候 我 说 不 推荐 使 用 可 视 


化 的 编辑 工具 ， 而 是 应 该 全 部 使 用 XML 的 方式 来 编写 界面 ， 现 在 你 是 不 是 
已 经 感觉 使 用 XML 非常 简单 了 呢 ? 以 后 不 管 面 对 多 么 复杂 的 界面 ， 我 硕 望 
你 都 能 够 目 信 满 满 ， 因 为 真正 理解 了 界面 编写 的 原理 之 后 ， 是 没有 什么 能 
够 难得 倒 你 的 。 


不 过 到 目前 为 止 ， 我 们 还 只 是 学 习 了 Android 手 机 方面 的 开发 技巧 ， 下 一 章 
将 会 涉及 一 些 Android 平 板 方面 的 知识 点 ， 能 够 同时 兼容 手机 和 平板 也 是 自 
Android 4.0 系 统 开始 就 支持 的 特性 。 适 当地 放松 和 休息 一 段 时 间 后 ， 我 们 再 
来 继续 前 行 吧 ! 


4 章 手机 平板 要 兼顾 一 一 探 扣 全 


当今 是 移动 设备 发 展 非常 迅速 的 时 代 ， 不 仅 手 机 已 经 成 为 了 生活 必需 品 ， 

束 连 平板 电脑 也 变 得 越 来 越 普 及 。 平 板 电 脑 和 手机 最 大 的 区 别 束 在 于 屏 闫 
的 大 小 ， 一 般 手 机 屏幕 的 大 小 会 在 3 英寸 到 6 英寸 之 间 ， 而 一 般 平 板 电 脑 屏 
幕 的 大 小 会 在 7 英寸 到 10 英 寸 之 间 。 屏 莫大 小 差距 过 大 有 可 能 会 让 同样 的 界 
面 在 视觉 效果 上 有 较 大 的 差异 ， 比 如 一 些 界面 在 手机 上 看 起 来 非常 美观 ， 

ee 
情况 。 


作为 一 名 专业 的 Android 开 发 人 员 ， 能 够 同时 兼顾 手机 和 平板 的 开发 是 我 们 
必须 做 到 的 事情 。Android 目 3.0 版 本 开始 引入 了 片 的 概念 ， 它 可 以 让 界面 
在 平板 上 更 好 地 展示 ， 下 面 我 们 喊 来 一 起 学 习 一 个。 


4.1 碎片 是 什么 


碎片 (Fragment) 是 一 种 可 以 答 入 在 活动 当中 的 UI 片段 ， 它 能 让 程序 更 加 
合理 和 充分 地 利用 大 屏 厌 的 空间 ， 因 而 在 平板 上 应 用 得 非常 广泛 。 虽然 碎 
上 对 你 来 说 应 该 是 个 全 新 的 概念 ， 但 我 相信 你 学 习 起 来 应 该 蝇 不 费力 ， 因 
为 它 和 活动 实在 是 太 像 了 ， 同 样 都 能 包 合 布 局 ， 同 样 都 有 目 己 的 生命 周 

期 。 你 甚至 可 以 将 碎片 理解 成 一 个 迷你 型 的 活动 ， 虽 然 这 个 迷你 型 的 活动 
有 可 能 和 普通 的 活动 是 一 样 大 的 。 


那么 究竟 要 如 何 使 用 碎 乒 才 能 充分 地 利用 平板 屏幕 的 空间 呢 ? 想象 我 们 正 
在 开发 一 个 新 闻 应 用 ， 其 中 一 个 界面 使 用 RecyclerView 展 示 了 一 组 新 闻 的 标 
题 ， 当 点 击 了 其 中 一 个 标题 时 ， 就 打开 另 一 个 界面 显示 新 闻 的 详细 内 容 。 
如 果 是 在 手机 中 设计 ， 我 们 可 以 将 新 闻 标 题 列 表 放 在 一 个 活动 中 ， 将 新 闻 
的 详细 内 容 放 在 男 一 个 活动 中 ， 如 图 4.1 所 示 。 


图 4.1 手机 的 设计 方案 


可 是 如 果 在 平板 上 也 这 么 设计 ， 那 么 新 闻 标 题 列表 将 会 被 拉 长 至 填充 满 整 
个 平板 的 屏幕 ， 而 新 闻 的 标题 一 般 都 不 会 太 长 ， 这 样 将 会 导致 界面 上 有 大 
量 的 空 日 区 域 ， 如 图 4.2 所 示 。 


图 4.2 平板 的 新 闻 列表 


因此 ， 更 好 的 设计 方案 是 将 新 闻 标 题 列表 界面 和 新 闻 详 细 内 容 界 面 分 别 放 
在 两 个 碎片 中 ， 然 后 在 同一 个 活动 里 引入 这 两 个 碎片 ， 这 样 就 可 以 将 屏幕 
空间 充分 地 利用 起 来 了 ， 如 图 4.3 所 示 。 


图 4.3 平板 的 双 页 设计 


4.2 ”人 雄 片 的 使 用 方式 


介绍 了 这 么 多 抽象 的 东西 ， 也 是 时 候 学 习 一 下 雁 片 的 具体 用 法 了 。 你 已 经 
知道 ， 碎 片 通常 都 是 在 平板 开发 中 使 用 的 ， 因 此 我 们 首先 要 做 的 就 是 创建 
一 个 平板 模拟 器 。 创 建 模 拟 器 的 方法 我 们 在 第 1 章 已 经 学 过 了 ， 创 建 完 成 后 
司 动 平 板 模拟 器 ， 效 末 如 图 4.4 所 示 。 


图 4.4 平板 模拟 器 的 运行 效果 


好 了 ， 准 备 工 作 都 完成 了 ， 接 着 新 建 一 个 FragmentTest 项 目 ， 然 后 开始 我 们 
的 人 肆 厂 探索 之 旅 吧 。 


4.2.1 ”他 片 的 简单 用 法 


这 里 我 们 准备 先 写 一 个 最 简单 的 碎片 示例 来 练 练 手 ， 在 一 个 活动 当中 添加 
两 个 碎片 ， 并 让 这 两 个 雁 片 平分 活动 空间 。 


新 建 一 个 左 侧 碎片 布局 left_fragment.xml， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/button" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" 
android:text="Button" 
/> 


</LinearLayout> 


这 个 布局 非常 简单 ， 只 放置 了 一 个 按钮 ， 并 让 它 水 平 居 中 显示 。 然 后 新 建 
右 侧 碎片 布局 right_fragment.xml， 代 码 如 下 所 示 : 


O 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:background="#00ff0O0" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" 
android:textSize="20sp" 
android:text="This is right fragment" 
/> 


</LinearLayout> 


可 以 看 到 ， 我 们 将 这 个 布局 的 背景 色 设置 成 了 绿色 ， 并 放置 了 一 个 TextView 
用 于 显示 一 段 文 本 。 


接着 新 建 一 个 LeftFragment 类 ， 并 让 它 继承 自 Fragment。 注 意 ， 这 里 可 能 会 
有 两 个 不 同 包 下 的 Fragment 供 你 选择 ， 一 个 是 系统 内 置 的 
android.app.Fragment， 一 个 是 support-v4 库 中 的 
android.support.v4.app.Fragment。 这 里 我 强烈 建议 你 使 用 support-v4 库 中 的 
Fragment， 因 为 它 可 以 让 雄 片 在 所 有 Android 系 统 版 本 中 保持 功能 一 任性 。 
比如 说 在 Fragment 中 蔚 套 使 用 Fragment， 这 个 功能 是 在 Android 4.2 系 统 中 才 
开始 支持 的 ， 如 果 你 使 用 的 是 系统 内 置 的 Fragment， 那 么 很 遗憾 ，4.2 系 统 
之 前 的 设备 运行 你 的 程序 区 会 朋 误 。 而 使 用 Support-v4 库 中 的 Fragment 残 不 
会 出 现 这 个 问题 ， 只 要 你 保证 使 用 的 是 最 新 的 Support-v4 库 束 可 以 了 。 吨 

外 ， 我 们 并 不 需要 在 build.gradle 文 件 中 添加 support-v4 库 的 依赖 ， 因 为 
build.gradle 文 件 中 已 经 添加 了 appcompat-v7 库 的 依赖 ， 而 这 个 库 会 将 support- 
v4 库 也 一 起 引入 进来 。 


现在 编写 一 下 LeftFragment 中 的 代码 ， 如 下 所 示 : 


public class LeftFragment extends Fragment { 


QOverride 
public View onCreateView(LayoutIinflater inflater, ViewGroup container, 
Bundle savedInstanceState) 
View view = inflater.inflate(R.]layout.1left_ fragment, container, false); 
return view; 


这 里 仅仅 是 重 写 了 Fragment 的 oncreateview() 方法 ， 然 后 在 这 个 方法 中 通过 
LayoutInflater 的 inflate() 方法 将 刚才 定义 的 I 局 动态 加 载 进 
来 ， 整 个 方法 简单 明了 。 接 着 我 们 用 同样 的 方法 再 新 建 一 个 RightFragment 

代码 如 下 所 示 : 


public class RightFragment extends Fragment { 


QOverride 
public View onCreateView(LayoutIinflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.]layout.right_fragment, container, false); 
return view; 


基本 上 代码 都 是 相同 的 ， 相 信 已 经 没有 必要 再 做 什么 解释 了 。 接 下 来 修改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<fragment 
android:id="@+id/left_fragment" 
android:name="com.example.fragmenttest.LeftFragment" 
android:layout_width="0Odp" 
android:layout_height="match_parent" 
android:layout_weight="1" /> 


<fragment 
android:id="@+id/right_fragment" 
android:name="com.example.fragmenttest.RightFragment" 
android:layout_width="0Odp" 
android:layout_height="match_parent" 
android:layout_weight="1" /> 


</LinearLayout> 


可 以 看 到 ， 我 们 使 用 了 <fragment> 标签 在 布局 中 添加 雄 片 ， 其 中 指定 的 大 
多 数 属 性 都 是 你 熟悉 的 ， 只 不 过 这 里 还 需要 通过 android:name 属性 来 显 式 


站 明 要 添加 的 碎片 类 名 ， 注 意 一 定 要 将 类 的 包 名 也 加 上 。 


这 样 最 简单 的 雄 片 示例 束 已 经 写 好 了 ， 现 在 运行 一 下 程序 ， 效 霖 如 图 4.5 所 
RR? 


FragmentTest 


图 4.5 碎片 的 简单 运行 效果 


正如 我 们 所 期 竺 的 一 样 ， 两 个 碎片 平分 了 整个 活动 的 布局 。 不 过 这 个 例子 
实在 是 太 简 单 了 ， 在 真正 的 项 目 中 很 难 有 什么 实际 的 作用 ， 因 此 我 们 马上 
来 看 一 看 ， 关 于 碎片 更 加 高 级 的 使 用 技巧 。 


4.2.2 ”动态 添加 苹 斤 

在 上 一 节 当 中 ， 你 已 经 学 会 了 在 布局 文件 中 添加 碎片 的 方法 ， 不 过 碎片 真 
正 的 强大 之 处 在 于 ， 它 可 以 在 程序 运行 时 动态 地 添加 到 活动 当中 。 根 据 具 
体 情况 来 动态 地 添加 碎片 ， 你 就 可 以 将 程序 界面 定制 得 更 加 多 样 化 。 


我 们 还 是 在 上 一 地 代码 的 基础 上 继续 完善 ， 新 建 
another_right_fragment.xml， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:background="#ffffO0" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" 
android:textSize="20sp" 
android:text="This is another right fragment" 
/> 


</LinearLayout> 


这 个 布局 文件 的 代码 和 right_fragment.xml 中 的 代码 基本 相同 ， 只 是 将 背景 
改 成 了 黄色 ， 并 将 显示 的 文字 改 了 改 。 然 后 新 建 AnotherRightFragment 作为 
另 一 个 右 侧 碎 卢 ， 代 码 如 下 所 示 : 


public class AnotherRightFragment extends Fragment { 


Q@Override 
public View onCreateView(LayoutIinflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.]layout.another_right_fragment, container, 
false); 
return view; 


代码 同样 非常 简单 ， 在 oncreateview( ) 方法 中 加 载 了 刚刚 创建 的 

another right_fragment 布 局 。 这 样 我 们 束 准 备 好 了 另 一 个 碎 族 ， 接 下 来 看 一 
下 如 何 将 它 动 态 地 添加 到 活动 当中 。 修 改 activity_main.xml， 代 码 如 下 所 
小: 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<fragment 
android:id="@+id/left_fragment" 
android:name="com.example.fragmenttest.LeftFragment" 
android:layout_width="0Odp" 
android:layout_height="match_parent" 
android:layout_weight="1" /> 


<FrameLayout 
android:id="@+id/right_layout" 


android:layout_width="0dp" 

android:layout_height="match_parent" 

android:layout_weight="1" > 
</FrameLayout> 


</LinearLayout> 


可 以 看 到 ， 现 在 将 右 侧 雁 片 蔡 换 成 了 一 个 FrameLayout 中 ， 还 记得 这 个 布局 
吗 ? 在 上 一 章 中 我 们 学 过 ， 这 是 Android 中 最 简单 的 一 种 布局 ， 所 有 的 控件 
默认 都 会 摆 放 在 布局 的 左上 角 。 由 于 这 里 仅 需 要 在 布局 里 放 入 一 个 碎片 ， 
不 需要 任何 定位 ， 因 此 非常 适合 使 用 FrameLayout 。 


下 面 我 们 将 在 代码 中 间 FrameLayout 里 添加 内 容 ， 从 而 实现 动态 添加 雄 片 的 
功能 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
Button button = (Button) findViewById(R.id.button); 
button.setOonclickListener(this); 
replaceFragment (new RightFragment()); 


} 


Q@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
replaceFragment (new AnotherRightFragment()); 
break; 
default: 
break; 
} 
} 


private void replaceFragment(Fragment fragment) { 
FragmentManager fragmentManager = getSupportFragmentManager(); 
FragmentTransaction transaction = fragmentManager .beginTransaction( ) ， 
transaction.replace(R.id.right_layout, fragment); 
transaction.commit(); 


可 以 看 到 ， 首 先 我 们 给 左 侧 碎 片 中 的 按钮 注册 了 一 个 点 击 事件 ， 然 后 调用 
replaceFragment() 方法 动态 添加 了 RightFragment 这 个 人 上 厂 。 当 点 击 左 侧 酚 
片 中 的 按钮 时 ， 又 会 调用 replaceFragment() 方法 将 右 侧 碎片 替换 成 


AnotherRightFragment ° 结合 replaceFragment() 方法 中 的 代码 可 以 看 出 ， 动 
态 添 加 雄 片 主要 分 为 5 步 。 


(1) 创建 竺 添加 的 雁 放 实例。 


(2) 获取 FragmentManager， 在 活动 中 可 以 直接 通过 调用 
getsupportFragmentManager() 方法 得 到 。 


(3) 开启 一 个 事务 ， 通 过 调用 beginTransaction() 方法 开启 。 


(4) 向 容器 内 添加 或 替换 碎片 ， 一 般 使 用 replace() 方法 实现 ， 需 要 传 入 容 
妖 的 id 和 待 添 加 的 碎片 实例 。 


(5) 提交 事务 ， 调 用 commit() 方法 来 完成 。 


这 样 就 完成 了 在 活动 中 动态 添加 碎片 的 功能 ， 重 新 运行 程序 ， 可 以 看 到 和 
之 前 相同 的 界面 ， 然 后 点 击 一 下 按钮 ， 效 末 如 图 4.6 所 示 。 


FragmentTest 


图 4.6 动态 添加 碎片 的 效果 


4.2.3 ”在 碎片 中 模拟 返回 栈 


在 上 一 小 证 中， 我们 成 功 实现 了 癌 活 动 中 动态 添加 碎片 的 功能 ， 不 过 你 洋 
试 一 下 束 会 发 现 ， 通 过 点 击 按钮 深 加 了 一 个 碎片 之 后 ， 这 时 按 下 Back 键 程 
序 束 会 直接 退出 。 如 采 这 里 我 们 想 模 仿 类 似 于 返回 栈 的 效果 ， 按 下 Back 键 
可 以 回 到 上 一 个 碎片 ， 该 如 何 实现 呢 ? 


其 实 很 简单 ，FragmentTransaction 中 提供 了 一 个 addToBackstack() 方法 ， 可 
以 用 于 将 一 个 事务 添加 到 返回 栈 中 ， 修改 MainActivity 中 的 代码 ， 如 下 所 
人 小: 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private void replaceFragment(Fragment fragment) { 
FragmentManager fragmentManager = getSupportFragmentManager(); 
FragmentTransaction transaction = fragmentManager .beginTransaction(); 
transaction.replace(R.id.right_layout, fragment); 
transaction.addToBackStack(null); 
transaction.commit(); 


} 


这 里 我 们 在 事务 提交 之 前 调用 了 FragmentTransaction 的 addToBackSstack() 方 
法 ， 它 可 以 接收 一 个 名 字 用 于 描述 返回 栈 的 状态 ， 一 般 传 入 nul1l 即 可 。 现 
在 重新 运行 程序 ， 并 点 击 按钮 将 AnotherRightFragment 活 加 到 活动 中 ， 然 后 
按 下 Back 键 ， 你 会 发 现 程序 并 没有 退出 ， 而 是 回 到 了 RightFragment 界 面 ， 
继续 按 下 Back 键 ，RightFragment 弄 面 也 会 消失 ， 再 次 按 下 Back 键 ， 程 序 才 
会 退出 。 


4.2.4 ”碎片 和 活动 之 间 进 行 通信 


虽然 雄 片 都 是 藤 入 在 活动 中 显示 的 ， 可 是 实际 上 它们 的 关系 并 没有 那么 节 
密 。 你 可 以 看 出 ,碎片 和 活动 都 是 各 目 存 在 于 一 个 独立 的 类 当中 的 ， 它 们 
之 间 并 没有 那么 明显 的 方式 来 直接 进行 通信 。 如 果 想 要 在 活动 中 调用 碎片 
里 的 方法 ， 或 者 在 碎片 中 调用 活动 里 的 方法 ， 应 该 如 何 实现 呢 ? 


为 了 方便 碎片 和 活动 之 间 进 行 通信 ，FragmentManager 提 供 了 一 个 类 似 于 
findviewById() 的 方法 ， 专 门 用 于 从 布局 文件 中 获取 雄 片 的 实例 ， 代 码 如 


下 丙 示 ， 


RightFragment rightFragment = (RightFragment) getSupportFragmentManager() 


.findFragmentById(R.id.right_fragment); 


调用 FragmentManager 的 findFragmentById() 方法 ， 可 以 在 活动 中 得 到 相应 
人 雄 片 的 实例 ， 然 后 就 能 轻松 地 调用 雄 片 里 的 方法 了 。 


掌握 了 如 何在 活动 中 调用 雁 族 里 的 方法 ， 那 在 雁 族 中 又 该 怎样 调用 活动 里 
的 方法 呢 ? 其 实 这 了 吏 更 简单 了 ， 在 每 个 碎片 中 都 可 以 通过 调用 
getActivity() 方法 来 得 到 和 当前 雁 片 相关 联 的 活动 实例 ， 代 码 如 下 所 示 : 


MainActivity activity = (MainActivity) getActivity(); 


有 了 活动 实例 之 后 ， 在 人 雄 片 中 调用 活动 里 的 方法 束 变 得 轻而易举 了 。 男 外 
当 雄 片 中 需要 使 用 context 对 象 时 ， 也 可 以 使 用 getActivity() 方法 ， 因 为 
获取 到 的 活动 本 和 号 就 是 一 个 context 对 象 。 


这 时 不 知道 你 心中 会 不 会 产生 一 个 疑问 : 既然 碎片 和 活动 之 间 的 通信 问题 
已 经 解决 了 ， 那 么 碎片 和 碎片 之 间 可 不 可 以 进行 通信 呢 ? 

说 实在 的 ， 这 个 问题 并 没有 看 上 去 那么 复杂 ， 它 的 基本 思路 非常 从 单 ， 衣 
先 在 一 个 碎片 中 可 以 得 到 与 它 相关 联 的 活动 ， 然 后 再 通过 这 个 活动 去 获取 
另外 一 个 碎片 的 实例 ， 这 样 也 就 实现 了 不 同 碎片 之 间 的 通信 功能 ， 因 此 这 
里 我 们 的 答案 是 肯定 的 。 


4.3 ”全 上 请 的 生命 周期 


和 活动 一 样 ， 雁 片 也 有 目 己 的 生命 周期 ， 并 且 它 和 活动 的 生命 周期 实在 是 
太 像 了 ， 我 相信 你 很 快 束 能 学 会 ， 下 面 我 们 马上 束 来 看 一 下 。 


4.3.1 ”他 片 的 状态 和 回调 


还 记得 每 个 活动 在 其 生命 周期 内 可 能 会 有 哪儿 种 状态 吗 ? 没 错 ， 一 共有 运 
行 状态 、 暂 停 状 态 、 停 止 状态 和 销毁 状态 这 4 种 。 类 似 地 ， 每 个 碎片 在 其 生 


命 周 期 内 也 可 能 会 经 历 这 几 种 状态 ， 只 不 过 在 一 些 细小 的 地 方 会 有 部 分 区 
| 


01. 运行 状态 
当 一 个 碎片 是 可 见 的 ， 并 且 它 所 关联 的 活动 正 处 于 运行 状态 时 ， 该 碎 
片 也 处 于 运行 状态 。 

02. 暂停 状态 
当 一 个 活动 进入 暂停 状态 时 〈 由 于 另 一 个 未 占 满 屏幕 的 活动 被 添加 到 
了 栈 顶 ) ， 与 它 相 关联 的 可 见 碎 片 加 会 进入 到 暂停 状态 。 

03. 停止 状态 
当 一 个 活动 进入 停止 状态 时 ， 与 它 相关 联 的 碎片 就 会 进入 到 停止 状 
态 ， 或 者 通过 调用 FragmentTransaction 的 remove() 、replace( ) 方法 将 
肆 片 从 活动 中 移 除 ， 但 如 果 在 事务 提交 之 前 调用 addToBackstack() 方 


法 ， 这 时 的 碎片 也 会 进入 到 停止 状态 。 总 的 来 说 ， 进 入 停止 状态 的 碎 
片 对 用 户 来 说 是 完全 不 可 见 的 ， 有 可 能 会 被 系统 回收 。 

04. 销毁 状态 
们 片 总 是 依附 于 活动 而 存在 的 ， 因 此 当 活 动 被 销毁 时 ， 与 它 相 关联 的 
丰 片 丈 会 进入 到 销毁 状态 。 或 者 通过 调用 FragmentIransaction 的 
remove() 、replace() 方法 将 人 雄 片 从 活动 中 移 除 ， 但 在 事务 提交 之 前 并 
没有 调用 addToBackstack() 方法 ， 这 时 的 碎片 也 会 进入 到 销毁 状态 。 


结合 之 前 的 活动 状态 ， 相 信 你 理解 起 来 应 该 色 不 费力 吧 。 同 样 地 ，Fragment 
类 中 也 提供 了 一 系列 的 回调 方法 ， 以 覆 兰 碎片 生命 周期 的 每 个 环节 。 其 

中 ， 活 动 中 有 的 回调 方法 ， 碎 片 中 几乎 都 有 ， 不 过 雁 片 还 提供 了 一 些 附 加 
的 回调 方法 ， 那 我 们 就 重点 看 一 下 这 几 个 回调 。 


onAttach()。 当 肆 片 和 活动 建立 关联 的 时 候 调用 。 
onCreateView()。 为 雄 片 创建 视图 (加 载 布 局 ) 时 调用 。 


onActivitycreated()。 确保 与 雄 片 相关 联 的 活动 一 定 已 经 创建 完毕 的 
时 候 调 用 。 


e onDestroyView() ° 当 与 碎片 关联 的 视图 被 移 除 的 时 候 调 用 。 
。 onDetach() 。 当 停 片 和 活动 解除 关联 的 时 候 调 用 。 
碎片 完整 的 生命 周期 示意 图 可 参考 图 4.7， 图 片 源 目 Android 官 网 。 


图 4.7 
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4.3.2 ”体验 碎片 的 生命 周期 


为 了 让 你 能 够 更 加 直观 地 体验 碎片 的 生命 周期 ， 我 们 还 是 通过 一 个 例子 来 
实践 一 下 。 例 子 很 简单 ， 仍 然 是 在 FragmentTest 项 目的 基础 上 改动 的 。 


修改 RightFragment 中 的 代码 ， 如 下 所 示 : 


public class RightFragment extends Fragment { 
public static final String TAG = "RightFragment"; 


QOverride 

public void onAttach(Context context) { 
super .onAttach(context ) ， 
Log.d(TAG, "onAttach"); 


} 


Q@Override 

public void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d(TAG, "onCreate"); 


QOverride 
public View onCreateView(LayoutIinflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
Log.d(TAG, "onCreateView"); 
View view = inflater.inflate(R.]layout.right_ fragment, container, false); 
return view; 


} 


Q@Override 

public void onActivityCreated(Bundle savedInstanceState) { 
super .onActivityCreated(savedInstanceState); 
Log.d(TAG, "onActivityCreated"); 


} 


QOverride 

public void onStart() { 
super .onStart() ， 
Log.d(TAG, "onStart"); 


} 


Q@Override 

public void onResume() { 
super .onResume(); 
Log.d(TAG, "onResume"); 


} 


Q@Override 

public void onPause() { 
super .onpause( ); 
Log.d(TAG, "onPause"); 


} 


QOverride 

public void onStop() { 
super .onStop() ， 
Log.d(TAG, "onStop"); 


Q@override 

public void onDestroyView() { 
super .onDestroyView( ) ， 
Log.d(TAG, "onDestroyView"); 


Q@Override 

public void onDestroy() { 
super .onDestroy(); 
Log.d(TAG, "onDestroy"); 


Q@Override 

public void onDetach() { 
super .onDetach( ) ， 
Log.d(TAG, "onDetach"); 


我 们 在 RightFragment 中 的 每 一 个 回调 方法 里 都 加 入 了 打印 日 志 的 代码 ， 然 


后 重新 运行 程序 ， 这 时 观察 logcat 中 的 打印 信息 ， 如 图 4.8 所 示 。 
verbose 国 @- RightFragment 3) 


com. example. fragmenttest D/RightFragment: onAttach 


com. example. fragmenttest D/RightFragment: onCreate 

com. example. fragmenttest D/RightFragment: onCreateView 

com. example. fragmenttest D/RightFragment: onActivityCreated 
com. example. fragmenttest D/RightFragment: onStart 


com. example. fragmenttest D/RightFragment: onResume 


图 4.8 ”启动 程序 时 的 打印 日 志 
可 以 看 到 ， 当 RightFragment 第 一 次 被 加 载 到 屏幕 上 时 ， 会 依次 执行 


onAttach( ) 、oncreate() 、 onCreateView() 、 onActivityCreated() 、 
onstart() 和 onResume() 方法 。 然 后 点 击 LeftFragment 中 的 按钮 ， 此 时 打印 
言 息 如 图 4. 9 所 示 ° 


S 
| Verbose 图 [IQ RightFragment 


com. example. fragmenttest D/RightFragment: onPause 
com. example. fragmenttest D/RightFragment: onStop 


com. example. fragmenttest D/RightFragment: onDestroyView 


图 4.9 ”替换 成 AnotherRightFragment 时 的 打印 日 志 


由 于 AnotherRightFragment 蔡 换 了 RightFragment， 此 时 的 RightFragment 进 入 
a 因此 onpause() 、 onStop() 和 和 onDestroyvView() 方法 会 得 到 执 
。 当然 如 果 在 替换 的 时 候 没 有 调用 addToBackstack() 方法 ， 此 时 的 
We 进入 销毁 状态 ， onDestroy() 和 onDetach() 方法 就 会 得 到 

执行 。 


接着 按 下 Back 键 ，RightFragment 会 重新 加 到 屏幕 ， 打 印信 息 如 图 4.10 所 示 。 


Verbose 图 (Q- RightFragment ) 


com. example. fragmenttest D/RightFragment: onCreateView 
com. example. fragmenttest D/RightFragment: onActivityCreated 
com. example. fragmenttest D/RightFragment: onStart 


com. example. fragmenttest D/RightFragment: onResume 
图 4.10 返回 RightFragment 时 的 打印 日 志 


由 于 RightFragment 重 新 加 到 了 运行 状态 ， 因 此 oncreateview() 、 
onActivityCreated() 、onStart() 和 onResume( ) 方法 会 得 到 执行 。 注 意 此 
时 oncreate( ) 方法 并 不 会 执行 ， 因为 我 们 借助 了 adoToBackstack) 方法 使 
得 RightFragment 并 没有 被 销毁 。 


现在 再 次 按 下 Back 键 ， 打 印信 息 如 图 4.11 所 示 。 


Verbose 图 (Qa: RightFragment 


com. example. fragmenttest D/RightFragment: onPause 

com. example. fragmenttest D/RightFragment: onStop 

com. example. fragmenttest D/RightFragment: onDestroyView 
com. example. fragmenttest D/RightFragment: onDestroy 


com. example. fragmenttest D/RightFragment: onDetach 


图 4.11 退出 程序 时 的 打印 日 志 


依次 会 J ， mn ， onDestroy ew) 、 onDestroy() 和 
onDetach( ) 方法 ， 最 终 将 雁 片 销毁 掉 。 这 样 雁 片 完整 的 生命 周期 你 也 体验 
了 一 这 、 是 不 是 理解 得 更 加 深刻 了 ? 


另外 值得 一 提 的 是 ， 在 雁 片 中 你 也 是 可 以 通过 onsaveInstancestate() 方法 
来 保存 数据 的 ， 因 为 进入 停止 状态 的 碎片 有 可 能 在 系统 内 存 不 足 的 时 候 被 
回收 。 保存 下 来 的 数据 在 oncreate( ) 、 onCreateView!() 和 
onActivitycreated() 这 3 个 方法 中 你 都 可 以 重新 得 到 ， 它 们 都 含有 一 个 
Bundle 类 型 的 savedInstancestate 参数 。 具 体 的 代码 我 就 不 在 这 里 给 出 了 ， 
如 有 果 你 瑟 记 了 该 如 何 编 写 ， 可 以 参考 2.4.5 小 闻 。 


4.4 ”动态 加 载 布局 的 技巧 


虽然 动态 添加 碎片 的 功能 很 强大 ， 可 以 解决 很 多 实际 开发 中 的 问题 ， 但 是 
它 毕竟 只 是 在 一 个 布局 文件 中 进行 一 些 添加 和 灶 换 操作 。 如 果 程序 能 够 根 
据 设备 的 分 辨 率 或 屏幕 大 小 在 运行 时 来 决定 加 载 哪个 布局 ， 那 我 们 可 发 挥 
的 空间 就 玩 多 了 。 因 此 本 节 我 们 就 来 深 计 一 下 Android 中 动态 加 开 布 局 的 堵 
ID 0o 


4.4.1 ”使 用 限定 符 


如 果 你 经 常 使 用 平板 电脑 ， 应 该 会 发 现 现在 很 多 的 平板 应 用 都 采用 的 是 双 
页 模式 (程序 会 在 左 侧 的 面板 上 显示 一 个 包含 子 项 的 列表 ， 在 右 侧 的 面板 
上 显示 内 容 ) ， 因 为 平板 电脑 的 屏幕 足够 大 ， 完 全 可 以 同时 显示 下 两 页 的 
内 容 ， 但 手机 的 屏幕 一 次 就 只 能 显示 一 页 的 内 容 ， 因 此 两 个 页 面 需要 分 开 


显示 。 


那么 怎样 才能 在 运行 时 判断 程序 应 该 是 使 用 双 页 模式 还 是 单 页 模式 呢 ? 这 
就 需要 借助 限定 符 (Qualifiers) 来 实现 了 。 下 面 我 们 通过 一 个 例子 来 学 习 
一 下 它 的 用 法 ， 修 改 FragmentTest 项 目 中 的 activity_main.xml 文 件 ， 代 人 码 如 下 
所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<fragment 
android:id="@+id/left_fragment" 
android:name="com.example.fragmenttest.LeftFragment" 
android:layout_width="match_parent" 
android:layout_height="match_parent"/> 


</LinearLayout> 


这 里 将 多 余 的 代码 都 删 掉 ， 只 留 下 一 个 左 侧 人 碎片 ， 并 让 它 充 满 整个 父 布 
局 。 接 着 在 res 目 录 下 新 建 layout-large 文 件 来， 在 这 个 文件 夹 下 新 建 一 个 布 
局 ， 也 叫 作 activity_main.xml， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<fragment 
android:id="@+id/left_fragment" 
android:name="com.example.fragmenttest.LeftFragment" 
android:layout_width="QOdp" 
android:layout_height="match_parent" 
android:layout_weight="1" /> 


<fragment 
android:id="@+id/right_fragment" 


android:name="com.example.fragmenttest.RightFragment" 
android:layout_width="Qdp" 
android:layout_height="match_parent" 
android:layout_weight="3" /> 


</LinearLayout> 


可 以 看 到 ，layout/activity_main 布 局 只 包含 了 一 个 雄 片 ， 即 单 页 模式 ， 而 
layout-large/ activity_main 布 局 包 合 了 两 个 雄 片 ， 即 双 页 模式 。 其 中 1arge 就 
是 一 个 限定 符 ， 那 些 屏幕 被 认为 是 large 的 设备 就 会 自动 加 载 layout-large 文 
件 夹 下 的 布局 ， 而 小 屏幕 的 设备 则 还 是 会 加 载 layout 文 件 夹 下 的 布局 。 


然后 将 MainActivity 中 replaceFragment() 方法 里 的 代码 注释 挥 ， 并 在 平板 模 
拟 器 上 重新 运行 程序 ， 效 果 如 图 4.12 所 示 。 


FragmentTest 


图 4.12 双 页 模式 运行 效果 


再 启动 一 个 手机 模拟 器 ， 并 在 这 个 模拟 器 上 重新 运行 程序 ， 效 末 如 图 4.13 所 
不 ° 


FragmentTest 


图 4.13 单 页 模式 运行 效果 
这 样 我 们 就 实现 了 在 程序 运行 时 动态 加 载 布局 的 功能 。 
Android 中 一 些 芝 见 的 限定 符 可 以 参考 下 表 。 


small ~ 小 屏 幕 设备 的 资源 
normal $ 时 FP 等 屏幕 设 的 资源 


large 是 给 大 屏幕 设 的 资源 
xlarge 是 供给 超大 屏幕 设备 的 资源 


屏幕 特征 | 限定 符 描述 


ee 提供 给 中 等 分 状 率 设备 的 资源 (120dpi~160dpi) 
分 辨 率 Pe 提供 给 高 分 辨 率 设备 的 资源 (160dpi~240dpi) 

ee 提供 给 超 高 分 辨 率 设备 的 资源 (240dpi~320dpi) 

xxhdpi 提供 给 超 超 高 分 辩 率 设备 的 资源 (320dpi~480dpi) 


an “| 提供 给 模 屏 设备 的 资源 
Port “| 提供 给 竖 屏 设备 的 资源 


4.4.2 ”使 用 最 小 宽度 限定 符 


在 上 一 小 节 中 我 们 使 用 1arge 限定 符 成 功 解 决 了 单 页 双 页 的 判断 问题 ， 不 过 
很 快 又 有 一 个 新 的 问题 出 现 了 ，1large 到 底 是 指 多 大 呢 ? 有 的 时 候 我 们 希望 
可 以 更 加 灵活 地 为 不 同 设备 加 载 布 局 ， 不 管 它们 是 不 是 被 系统 认定 为 large 
， 这 时 就 可 以 使 用 最 小 宽度 限定 符 (Smallest-width Qualifier) 了 。 


最 小 宽度 限定 符 允 许 我 们 对 屏幕 的 蜗 度 指定 一 个 最 小 值 《以 dp 为 单位 ) ， 
然后 以 这 个 最 小 值 为 临界 点 ， 屏 幕 贺 度 大 于 这 个 值 的 设备 束 加 载 一 个 布 
局 ， 屏 幕 宽度 小 于 这 个 值 的 设备 就 加 载 男 一 个 布局 。 


在 res 目 录 下 新 建 layout-sw600dp 文 件 来 ， 然 后 在 这 个 文件 夹 下 新 建 
activity_main.xml 布 局 ， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<fragment 
android:id="@+id/left_fragment" 
android:name="com.example.fragmenttest.LeftFragment" 
android:layout_width="QOdp" 
android:layout_height="match_parent" 
android:layout_weight="1" /> 


<fragment 
android:id="@+id/right_fragment" 
android:name="com.example.fragmenttest.RightFragment" 
android:layout_width="0Odp" 
android:layout_height="match_parent" 
android:layout_weight="3" /> 


</LinearLayout> 


这 就 意味 着 ， 当 程序 运行 在 屏幕 宽度 大 于 600dp 的 设备 上 时 ， 会 加 载 layout- 
sw600dpy/activity_main 布 局 ， 当 程序 运行 在 屏幕 宽度 小 于 600dp 的 设备 上 
时 ， 则 仍然 加 载 默认 的 layoutactivity_main 布 局 。 


4.5 ” 雁 族 的 最 佳 实践 一 一 一 个 简易 版 的 
新 闻 应 用 


现在 你 已 经 将 关于 雄 片 的 重要 知识 点 都 掌握 得 差不多 了 ， 不 过 在 灵活 运用 
方面 可 能 还 有 些 欠缺 ， 因 此 下 面 该 进入 我 们 本 章 的 最 佳 实践 环节 了 。 


前 面 有 提 到 过 ， 碎 片 很 多 时 候 都 是 在 平板 开发 当中 使 用 的 ， 主 要 是 为 了 解 
决 屏 幕 空间 不 能 充分 利用 的 问题 。 那 古 不 古 束 表明 ， 2 
要 提供 一 个 手机 版 和 一 个 Pad 版 呢 ? 确实 有 不 少 公司 部 是 这 么 做 的 ， 但 是 

样 会 浪费 很 多 的 人 力 物 力 。 因 为 维护 两 个 版 本 的 代码 成 本 很 高 ， 乱 当 培 加 
什么 新 功能 时 ， 需 要 在 两 份 代码 里 各 写 一 裔 ， 每 当 发 现 一 个 bug 时 ， 需要 在 
两 份 代码 里 各 修改 一 次 。 因 此 今天 我 们 最 佳 实践 的 内 容 束 是 ， 教 你 如 何 编 
写 同 时 兼容 手机 和 平板 的 应 用 程序 。 


还 记得 在 本 章 开 始 的 时 候 提 到 过 的 一 个 新 闻 应 用 吗 ” 现在 我 们 就 将 运用 本 
章 中 所 学 的 知识 来 编写 一 个 简易 版 的 新 闻 应 用 ， 并 且 要 求 它 是 可 以 同时 兼 
容 手 机 和 平板 的 。 痢 建 好 一 个 FragmentBestPractice 项 目 ， 然 后 开始 动手 吧 ! 


由 于 竺 会 在 编写 新 闻 列 表 时 会 使 用 到 RecyclerView， 因 此 首先 需要 在 
app/build.gradle 当 中 添加 依赖 库 ， 如 下 所 示 : 


dependencies { 
compile fileTrree(dir: 'libs', include: ['*.jar' 二 
compile 'com.android. support: appcompat-v7:24.2. 
testCompile ‘junit:junit:4.12" 


compile 'com.android.support:recyclerview-v7:24.2.1' 


返 下 来 我 们 要 准备 好 一 个 新 闻 的 实体 类 ， 新 建 类 News ， 代 码 如 下 所 示 : 


public class News { 


private String title,; 


private String content 


public String getTitle() { 
return title; 


} 


public void setTitle(String title) { 
this.title = title; 


} 


public String getContent() { 
return content; 


} 


public void setContent(String content) { 
this.content = content ， 


} 


News 类 的 代码 还 是 比较 简单 的 ，title 字段 表示 新 闻 标 题 ，content 字段 表 


示 新 闻 内 容 。 接 着 新 建 布局 文件 news_content_frag.xml， 用 


的 布局 : 


于 作为 新 闻 内 容 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<LinearLayout 


android:id="@+id/visibility_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:orientation="vertical" 
android:visibility="invisible" > 


<TextView 
android: 
android: 
android: 
android: 
android: 
android: 


<View 
android: 
android: 
android: 


<TextView 
android: 
android: 
android: 
android: 
android: 
android: 


</LinearLayout> 


id="@+id/news_title" 
lJayout_width="match_parent" 
Jayout_height="wrap_content" 
gravity="center" 
padding="10dp" 
textSize="20sp" /> 


lJayout_width="match_parent" 
Jayout_height="1idp" 
background="#000" /> 


id="@+id/news_content" 
lJayout_width="match_parent" 
layout_height="Qdp" 

lJayout_ weight="1" 
padding="15dp" 
textSize="18sp" /> 


<View 
android:layout_width="1dp" 
android:layout_height="match_parent" 
android:layout_alignParentLeft="true" 
android:background="#000" /> 


</RelativeLayout> 


新 闻 内 容 的 布局 主要 可 以 分 为 两 个 部 分 ， 头 部 部 分 显示 新 闻 标 题 ， 正 文部 
分 显示 新 闻 内 容 ， 中 间 使 用 一 条 细 线 分 隔 开 。 这 里 的 细 线 是 利用 View 来 实 
现 的 ， 将 View 的 宽 或 高 设置 为 ltp， 再 通过 background 属性 给 细 线 设置 一 下 
颜色 残 可 以 了 。 这 里 我 们 把 细 线 设置 成 肤色 。 


然后 再 新 建 一 个 NewscontentFragment 类 ， 继 承 自 Fragment， 代 码 如 下 所 


人 小: 


public class NewsContentFragment extends Fragment { 
private View view; 


QOverride 
public View onCreateView(LayoutIinflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
view = inflater.inflate(R.layout.news_content_frag, container, false); 
return view; 


} 


public void refresh(String newsTitle, String newsContent) { 


View visibilityLayout = view.findViewById(R.id.visibility_layout); 
visibilityLayout.setVisibility(View.VISIBLE); 


TextView newsTitleText = (TextView) view.findViewById (R.id.news_ title); 
TextView newsContentText = (TextView) view.findViewById(R.id.news_content); 
newsTitleText.setText(newsTitle); // 刷新 新 闻 的 标题 
newsContentText.setText(newsContent); // 刷新 新 闻 的 内 容 


首先 在 oncreateview( ) 方法 里 加 载 了 我 们 刚刚 创建 的 news_content_frag 布 
局 ， 这 个 没什么 好 解释 的 。 接 下 来 又 提供 了 一 个 refresh( ) 方法 ， 这 个 方法 
束 是 用 于 将 新 闻 的 标题 和 内 容 显 示 在 界面 上 的 。 可 以 看 到 ， 这 里 通过 
findViewById() 方法 分 别 获取 到 新 闻 标 题 和 内 容 的 控件 ， 然 后 将 方法 传递 
进来 的 参数 设置 进去 。 


这 样 我们 束 把 新 闻 内 容 的 碎片 和 布局 都 创建 好 了 ， 但 是 它们 都 是 在 双 页 模 
式 中 使 用 的 ， 如 果 想 在 单 页 模式 中 使 用 的 话 ， 我 们 还 需要 再 创建 一 个 活 


动 。 右 击 com.example.fragmentbestpractice 包 ~ New 一 Activity Empty 
Activity， 新 建 一 个 NewsContentActivity， 并 将 布局 名 指定 成 news_content， 
然后 修改 news_content.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<fragment 
android:id="@+id/news_content_fragment" 
android:name="com.example.fragmentbestpractice.NewsContentFragment" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
/> 


</LinearLayout> 


这 里 我 们 充分 发 挥 了 代码 的 复 用 性 ， 直 接 在 布局 中 引入 了 
NewsCcontentFragment ， 这 样 也 就 相当 于 把 news_content_frag 布 局 的 内 容 自 
动 加 了 进来 。 


然后 修改 NewscontentActivity 中 的 代码 ， 如 下 所 示 : 


public class NewsContentActivity extends AppCompatActivity { 


public static void actionStart(Context context, String newsTitle, String 
newsContent) { 
Intent intent = new Intent(context, NewsContentActivity.class); 
intent.putExtra("news_title", newsTitle); 
intent.putExtra("news_content", newsContent); 
context.startActivity(intent); 


} 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setCcontentView(R.1layout.news_content); 
String newsTitle = getIntent().getSstringExtra("news_title"); // 获取 传 入 的 新 
闻 标 题 
String newsContent = getIntent().getstringExtra("news_content"); // 获取 传 入 
的 新 闻 内 容 
NewsContentFragment newsContentFragment = (NewsContentFragment) 
getSupportFragmentManager().findFragmentById(R.id.news_content_fragment); 
newsContentFragment.refresh(newsTitle, newsContent); // 刷 新 NewsContent - 
Fragment 界 面 


可 以 看 到 ， 在 oncreate( ) 方法 中 我 们 通过 Intent 获 取 到 了 传 入 的 新 闻 标 题 和 
新 闻 内 容 ， 然后 调用 FragmentManager 的 findFragmentById() 方法 得 到 了 
NewsContentFragment 的 实例 ， 接着 调用 它 的 refresh() 方法 ， 并 将 新 闻 的 
标题 和 内 容 传 入 ， 就 可 以 把 这 些 数据 显示 出 来 了 。 注 意 这 里 我 们 还 提供 了 
一 个 actionstart () 方法 ， 还 记得 它 的 作用 吗 ? 如 果 走 记 的 话 束 再 去 阅读 一 
人 遍 2.6.3 小 节 吧 。 


接 下 来 还 需要 再 创建 一 个 用 于 显示 新 闻 列 表 的 布局 ， 新 建 
news_title_frag.xml， 代 人 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.v7.widget.RecyclerView 
android:id="@+id/news_title_recycler_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
/> 


</LinearLayout> 


这 个 布局 的 代码 束 非 常 侧 音 了， 里 面 只 有 一 个 用 于 显示 新 闻 列 表 的 
RecyclerView。 既然 要 用 到 RecyclerView， 那 么 就 必定 少不了 子 项 的 布局 。 
新 建 news_item.xml 作 为 RecyclerView 子 项 的 布局 ， 人 代码 如 下 所 示 : 


<TextView xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/news_title" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:maxLines="true" 
android:ellipsize="end" 
android:textSize="18sp" 
android:paddingLeft="10dp" 
android:paddingRight="10dp" 
android:paddingTop="1i5dp" 
android:paddingBottom="1i5dp" /> 


子 项 的 布局 也 非常 简单 ， 只 有 一 个 TextView。 仔 细 观 察 TextView， 你 会 发 现 
其 中 有 几 个 属性 是 我 们 之 前 没有 学 过 的 。android:padding 表示 给 控件 的 周 
围 加 上 补 自 ， 这 样 不 至 于 让 文本 内 容 会 紧 靠 在 边 绿 上 。android:maxLines 

设置 为 true 表示 让 这 个 TextView 只 能 单行 显示 。android:ellipsize 用 于 设 


定 当 文本 内 容 超 出 控件 宽度 时 ， 文 本 的 缩 略 方式 ， 这 里 指定 成 end 表示 在 尾 
部 进行 缩 略 。 


既然 新 闻 列 表 和 子 项 的 布局 都 已 经 创建 好 了 ， 那 么 接 下 来 我 们 就 需要 一 个 
用 于 展示 新 闻 列 表 的 地 方 。 这 里 新 建 NewsTitleFragment 作为 展示 新 闻 列 表 
的 和 俯 片 ， 代 码 如 下 所 示 : 


public class NewsTitleFragment extends Fragment { 


private boolean isTwoPane; 


Q@Override 
public View onCreateView(LayoutIinflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.layout.news_ title frag, container, false); 
return view; 


} 


Q@Override 
public void onActivityCreated(Bundle savedInstanceState) { 
super .onActivityCreated(savedInstancesState); 
if (getActivity().findViewById(R.id.news_ content_ layout) != null) { 
isTwoPane = true; // 可 以 找到 news_content_layout 布 局 时 ， 为 双 页 模式 
} else { 
isTwoPane = false; // 找 不 到 news_content_layout 布 局 时 ， 为 单 页 模式 


可 以 看 到 ，NewsTitleFragment 中 并 没有 和 多少 代码 ， 在 oncreateview() 方法 
中 加 载 了 news_title_frag 布 局 ， 这 个 没什么 好 说 的 。 我 们 注意 看 一 下 
onActivitycreated() 方法 ， 这 个 方法 通过 在 活动 中 能 否 找到 一 个 id 为 
news_content_layout 的 View 来 判断 当前 是 双 页 模式 还 是 单 页 模式 ， 因 此 我 们 
需要 让 这 个 id 为 news_content_layout 的 View 只 在 双 页 模式 中 才 会 出 现 。 


那么 怎样 才能 实现 这 个 功能 呢 ? 其 实 并 不 复杂 ， 只 需要 借助 我 们 刚刚 学 过 
的 限定 符 就 可 以 了 。 首 先 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/news_title _ layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<fragment 
android:id="@+id/news_title_fragment" 
android:name="com.example.fragmentbestpractice.NewsTitleFragment" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
/> 


</FrameLayout> 


上 述 代码 表示 ， 在 单 页 模式 下 ， 只 会 加 载 一 个 新 闻 标 题 的 碎片 。 


然后 新 建 ljayout-sw600dp 文 件 夹 ， 在 这 个 文件 夹 下 再 新 建 一 个 
activity_main.xml 文 件 ， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<fragment 
android:id="@+id/news_title_ fragment" 
android:name="com.example.fragmentbestpractice.NewsTitleFragment" 
android:layout_width="QOdp" 
android:layout_height="match_parent" 
android:layout_weight="1" /> 


<FrameLayout 
android:id="@+id/news_content_Jlayout" 
android:layout_width="QOdp" 
android:layout_height="match_parent" 
android:layout_weight="3" > 


<fragment 
android:id="@+id/news_content_fragment" 
android:name="com.example.fragmentbestpractice.NewsContentFragment" 
android:layout_width="match_parent" 
android:layout_height="match_parent" /> 
</FrameLayout> 


</LinearLayout> 


可 以 看 出 ， 在 双 页 模式 下 我 们 同时 引入 了 两 个 雄 片 ， 并 将 新 闻 内 容 的 雄 片 
放 在 了 一 个 FrameLayout 布 局 下 ， 而 这 个 布局 的 id 正 是 news_content_layout 。 
因此 ， 能 够 找到 这 个 id 的 时 候 就 是 双 页 模式 ， 否 则 了 驶 是 单 面 模式 。 


现在 我 们 已 经 将 绝 大 部 分 的 工作 都 完成 了 ， 但 还 剩 下 至 关 重 要 的 一 点 ， 融 
是 在 NewsTitleFragment 中 通过 RecyclerView 将 新 闻 列 表 展 示 出 来 。 0 
News TitlePr agment 中 新 建 一 个 内 部 类 NewsAdapter 来 作为 RecyclerView 的 适 
配 禹 ， 如 下 所 示 : 


public class NewsTitleFragment extends Fragment { 


private boolean ISTwoPane ， 


class NewsAdapter extends RecyclerVvView,Adapter<NewSAdapter .ViewHolder> { 
private List<News> mNewsList,; 
class ViewHolder extends RecyclerView.ViewHolder { 
TextView newsTitleText,; 


public ViewHolder(View view) { 
super (view); 
newsTitleText = (TextView) view.findViewById(R.id.news_ title); 


} 


public NewsAdapter(List<News> newsList) { 
mNewsList = newsList,; 
} 


Q@Override 
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { 
View view = LayoutInflater.from(parent.getContext()) 
.inflate(R.layout.news_item, parent, false); 
final ViewHolder holder = new ViewHolder (view); 
view,.setOoncClickListener(new View.OnClickListener() { 
Q@Override 
public void onClick(View v) { 
News news = mNewsList.get(holder.getAdapterPosition()); 
if (isTwoPane) { 
// 如 果 是 双 页 模式 ， 则 刷新 NewsContentFragment 中 的 内 容 
NewsContentFragment newsContentFragment = 
(NewsContentFragment) getFragmentManager() 
.findFragmentById(R.Id.news_content_fragment ) ， 
newSsContentFragment refresh(news .getTitle()， 
news ,getContent( ) ) 
} else { 
// 如 果 是 单 页 模式 ， 则 直接 启动 NewsContentActivity 
NewsContentActivity,actionStart(getActivity( )， 
news.getTitle(), news.getContent()); 


} 
} 
}); 
return holder; 
} 
@Override 


public void onBindViewHolder (ViewHolder holder, int position) { 
News news = mNewsList.get(position); 
holder .newsTitleText.setText(news.getTitle()); 


} 


@Override 
public int getItemCount() { 
return mNewsList.size(); 


} 


Recyclerview 的 用 法 你 已 经 相当 熟练 了 ， 因 此 这 个 适配器 的 代码 对 你 来 说 
应 该 没有 什么 难度 吧 ? 需要 注意 的 是 ， 之 前 我 们 都 是 将 适配器 写成 一 个 独 
立 的 类 ， 其 实 也 是 可 以 写成 内 部 类 的 ， 这 里 写成 内 部 类 的 好 处 束 古 可 以 直 


Ne en ne 的 变量 ， 比 如 isTwoPane 。 


观察 一 下 oncreateviewHolder() 方法 中 注册 的 点 击 事件 ， 首 先 获取 到 了 点 击 
项 的 News 实例 ， 然 后 通过 isTwoPane 变量 来 判断 当前 是 单 页 还 是 双 页 模式 ， 
如 果 是 单 页 模式 ， 束 启动 一 个 新 的 活动 去 显示 新 闻 内 容 ， 如 果 是 双 页 模 
式 ， 就 更 狐 狐 闻 内 容 人 碎片 里 的 数据 。 


现在 还 剩 最 后 一 步 收尾 工作 ， 就 是 向 Recyclerview 中 填充 数据 了 。 修 改 
NewsTitleFragment 中 的 代码 ， 如 下 所 示 : 


public class NewsTitleFragment extends Fragment { 


Q@Override 
public View onCreateView(LayoutIinflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.layout.news_ title frag, container, false); 
RecyclerView newsTitleRecyclerView = (RecyclerView) view.findViewById 
(R.id.news_title_recycler_view); 
LinearLayoutManager layoutManager = new LinearLayoutManager (getActivity()); 
newsTitleRecyclerView.setLayoutManager (layoutManager ); 
NewsAdapter adapter = new NewsAdapter (getNews()); 
newsTitleRecyclerView.setAdapter (adapter); 
return view; 


} 


private List<News> getNews() { 
List<News> newsList = new ArrayList<>(); 
for (int i = 1; i <= 50; i++) { 
News news = new News(); 
news.setTitle("This is news title " + i); 
news.setContent(getRandomLengthContent("This is news content " + i+ "., ")); 
newsList.add(news); 


return newsList,; 


} 


private String getRandomLengthContent(String content) { 
Random random = new Random( ); 
int length = random.nextInt(20) + 1; 
StringBuilder builder = new StringBuilder(); 
for (int i = 0; i < length; i++) { 
builder .append(content); 
} 


return builder.toString(); 


可 以 看 到 ， onCreateView!() 方法 中 添加 了 RecyclerView 标准 的 使 用 方法 ， 

在 雄 片 中 使 用 Recyclerview 和 在 活动 中 使 用 几乎 是 一 模 一 样 的 ， 相 信 没 有 

什么 需要 解释 的 。 另 外 ， 这 里 调用 了 getNews( ) 方法 来 初始 化 50 条 模拟 新 闻 

数据 ， 同 样 使 用 了 一 个 getRandomLengthcontent() 方法 来 随机 生成 狐 闻 内 容 

ee 
了 了 o 


这 样 我 们 所 有 的 编写 工作 就 已 经 完成 了 ， 赶 快 来 运行 一 下 吧 ! 首先 在 手机 
模拟 器 上 运行 ， 殖 果 如 图 4.14 所 示 。 
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图 4.14 单 页 模式 的 新 闻 列表 界面 


可 以 看 到 许多 条 新 闻 的 标题 ， 然 后 点 击 第 一 条 新 闻 ， 会 局 动 一 个 新 的 活动 
来 显示 新 闻 的 内 容 ， 效 果 如 图 4.15 所 示 。 


图 4.15 单 页 模式 的 新 闻 内 容 界 面 
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接 下 来 将 程序 在 平板 模拟 器 上 运行 


未。 


， 同 样 点 击 第 


一 条 新 闻 ， 


效果 如 图 4.16 所 
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图 4.16 双 页 模式 的 新 闻 标 题 和 内 容 界面 


怎么 样 ? 同样 的 一 份 代码 ， 在 手机 和 平板 上 运行 却 分 别 是 两 种 完全 不 同 的 
效果 ， 说 明 我 们 程序 的 兼容 性 已 经 相当 不 错 了 。 通 过 这 个 例子 ， 我 相信 你 
对 碎片 的 理解 一 定义 加 深 了 很 多 ， 现 在 丈 让 我 们 一 起 来 忌 结 一 下 吧 。 


4.6 ”小结 与 点评 


你 应 该 可 以 感觉 到 ， 上 一 市 中 我 们 开发 的 新 闻 应 用 ， 代 码 复 光度 还 是 有 点 
高 的 ， 比 起 只 需要 兼容 一 个 终端 的 应 用 ， 我 们 要 考虑 的 东西 多 了 很 多 。 不 
过 在 开发 的 过 程 中 多 付出 一 些 ， 在 以 后 的 代码 维护 中 束 可 以 轻松 很 多 。 
此 ， 有 时候 提前 的 付出 还 是 很 值得 的 。 


我 们 再 来 回顾 一 下 本 章 所 学 的 内 容 吧 ， 首 先 你 了 解 了 碎片 的 基本 概念 以 及 
使 用 场景 ， 接 着 通过 几 个 实例 掌握 了 雁 斤 的 常见 用 法 ， 随 后 又 学 习 了 碎片 
生命 周期 的 相关 内 容 以 及 动态 加 载 布局 的 技巧 ， 最 后 在 本 章 的 最 住 实践 部 
分 将 前 面 所 学 的 内 容 综合 运用 了 一 遍 ， 相 信 你 已 经 将 碎片 相关 知识 点 都 牢 
记 在 心 ， 并 可 以 较为 熟练 地 应 用 了 。 


本 章 其 实 是 具有 一 个 里 程 碑 式 的 纪念 意义 的 ， 因 为 到 这 里 为 止 ， 我 们 已 经 
基本 将 Android UI 相 关 的 重要 知识 点 都 讲 完 了 。 后 面 在 很 长 一 段 时 间 内 都 不 
会 再 系统 性 地 介绍 UI 方面 的 知识 ， 而 是 将 结合 前 面 所 学 的 UI 知识 来 更 好 地 
讲解 相应 章节 的 内 容 。 那 么 我 们 下 一 章 将 要 学 习 什 么 呢 ? 还 记得 在 第 1 章 里 
介绍 过 的 Android 四 大 组 件 吧 ? 目前 我 们 只 掌握 了 活动 这 一 个 组 件 ， 那 么 下 
一 章 就 来 学 习 广 播 接收 器 吧 。 跟 上 脚步 ， 准 备 继续 前 进 ! 


- 5 章 全 局 大 喇叭 一 一 详解 广播 机 


记得 在 我 上 学 的 时 候 ， 每 个 班级 的 教室 里 都 会 装 有 一 个 喇叭 ， 这 些 喇 叭 都 
是 接 入 到 学 校 的 广播 室 的 ， 一 旦 有 什么 重要 的 通知 ， 就 会 播放 一 条 广播 来 
告知 全 校 的 师 生 。 类 似 的 工作 机 制 其 实在 计算 机 领域 也 有 很 广泛 的 应 用 ， 
如 果 你 了 解 网 络 通信 原理 应 该 会 知道 ， 在 一 个 IP 网 络 范 围 中 ， 最 大 的 IP 地 址 
是 被 保留 作为 广播 地 址 来 使 用 的 。 比 如 某 个 网 络 的 IP 范 围 是 
192.168.0.XXX， 子 网 掩 码 是 255.255.255.0， 那 么 这 个 网 络 的 广播 地 址 就 是 
192.168.0.255。 广 播 数据 包 会 被 发 送 到 同一 网 络 上 的 所 有 端口 ， 这 样 在 该 网 
络 中 的 每 台 主 机 都 将 会 收 到 这 条 广播 。 


为 了 便于 进行 系统 级 别 的 消息 通知 ，Android 也 引入 了 一 套 类 似 的 广播 消息 
机 制 。 相 比 于 我 前 面 举 出 的 两 个 例子 ，Android 中 的 广播 机 制 会 显得 更 加 灵 
活 ， 本 章 就 将 对 这 一 机 制 的 方方面面 进行 详细 的 讲解 。 


5.1 广播 机 制 简介 


为 什么 说 Android 中 的 广播 机 制 更 加 灵活 呢 ? 这 是 因为 Android 中 的 每 个 应 用 
程序 都 可 以 对 自己 感 兴趣 的 广播 进行 注册 ， 这 样 该 程序 就 只 会 接收 到 自己 
所 关心 的 广播 内 容 ， 这 些 广 播 可 能 是 来 自 于 系统 的 ， 也 可 能 是 来 自 于 其 他 
应 用 程序 的 。Android 提 供 了 一 套 完整 的 API， 人 允许 应 用 程序 自由 地 发 送 和 
接收 广播 。 发 送 广播 的 方法 其 实 之 前 稍微 提 到 过 ， 如 果 你 记性 好 的 话 可 能 
还 会 有 印象 ， 就 是 借助 我 们 第 2 章 学 过 的 Intent。 而 接收 广播 的 方法 则 需要 3 
入 一 个 新 的 概念 一 一 广播 接收 器 (Broadcast Receiver) 。 


广播 接收 名 的 具体 用 法 将 会 在 下 一 市 中 做 介绍 ， 这 里 我 们 先 来 了 解 一 下 广 
播 的 类 型 。Android 中 的 广播 主要 可 以 分 为 两 种 类 型 : 标准 广播 和 有 序 广 
播 。 


。 标准 广播 (Normal broadcasts) 是 一 种 完全 异步 执行 的 广播 ， 在 广播 发 
出 之 后 ， 所 有 的 广播 接收 器 几乎 都 会 在 同一 时 刻 接收 到 这 条 广播 消 


轧 ， 因 此 它们 之 间 没 有 任何 先后 顺序 可 言 。 这 种 广播 的 效率 会 比较 
高 ， 但 同时 也 意味 着 它 是 无 法 被 截断 的 。 标 准 广播 的 工作 流程 如 图 5.1 
所 全 和 
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图 5.1 标准 广播 工作 示意 图 


。 有 序 广播 (Ordered broadcasts) 则 是 一 种 同步 执行 的 广播 ， 在 广播 发 
出 之 后 ， 同 一 时 刻 只 会 有 一 个 广播 接收 妖 能 够 收 到 这 条 广播 消息 ， 当 
这 个 广播 接收 器 中 的 逻辑 执行 完毕 后 ， 广 播 才 会 继续 传递 。 所 以 此 时 
的 广播 接收 器 是 有 先后 顺序 的 ， 优 先 级 高 的 广播 接收 器 就 可 以 先 收 到 
广播 消息 ， 并 且 前 面 的 广播 接收 器 还 可 以 截断 正在 传递 的 广播 ， 这 样 
人 。 有 序 广播 的 工作 流程 如 图 
5.2 甩 不 。 
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图 5.2 有 序 广播 工作 示意 图 


掌握 了 这 些 基 本 概念 后 ， 我 们 束 可 以 来 尝试 一 下 广播 的 用 法 了 ， 首 先 束 从 
接收 系统 广播 开始 吧 。 


5.2 ”接收 系统 广播 


0 我 们 可 以 在 应 用 程序 中 通过 监听 这 些 
广播 来 得 到 各 种 系统 的 状态 信息 。 比 如 手机 开机 完成 后 会 发 出 一 条 广播 ， 
电池 的 电量 发 生变 化 会 发 出 一 条 条 广播 ， 时 间或 时 区 发 生 改变 也 会 发 出 一 条 
广播 ， 等 等 。 如 果 想 要 接收 到 这 些 广播 ， 就 需要 使 用 广播 接收 器 ， 下 面 我 
们 就 来 看 一 下 它 的 具体 用 法 。 


5.2.1 动态 注册 监听 网 络 变化 


广播 接收 器 可 以 目 由 地 对 自己 感 兴趣 的 广播 进行 注册 ， 这 样 当 有 相应 的 广 
播发 出 时 ， 广 播 接收 器 就 能 够 收 到 该 广播 ， 并 在 内 部 处 理 相 应 的 逻辑 。 注 
册 广 播 的 为 式 一 般 有 两 种 ， 在 代码 中 注册 和 在 AndroidManifest.xml 中 注册 ， 
其 中 前 者 也 被 称 为 动态 注册 ， 后 者 也 被 称 为 静态 注册 。 


那么 该 如 何 创建 一 个 广播 接收 器 呢 ? 其 实 只 需要 新 建 一 个 类 ， 让 它 继承 自 
BroadcastReceliver ， 并 重 写 父 类 的 onReceive() 方法 就 行 了 这 样 当 有 广 
播 到 来 时 ，onReceive() 方法 融会 得 到 执行 ， 有 具体 的 逻辑 瓯 可 以 在 这 个 方法 
申 处 理 : 


那 我 们 了 驶 移 通 过 动态 注册 的 方式 编写 一 个 能 够 监听 网 络 变化 的 程序 ， 借 此 
学 习 一 下 广播 接收 器 的 基本 用 法 吧 。 新 建 一 个 BroadcastTest 项 目 ， 然 后 修改 


MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private IntentFilter intentrFilter,; 


private NetworkChangeReceiver networkChangeReceiver; 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
intentFilter = new IntentFilter(); 
intentFilter.addAction("android.net.conn.CONNECTIVITY_CHANGE"); 
networkChangeReceiver = new NetworkChangeReceiver(); 
registerReceiver(networkChangeReceiver, intentrFilter); 


} 


Q@Override 
protected void onDestroy() { 
super .onDestroy(); 
unregisterReceiver (networkChangeReceiver); 


} 


class NetworkChangeReceiver extends BroadcastReceiver { 


Q@Override 
public void onReceive(Context context, Intent intent) { 
Toast.makeText(context, "network changes", Toast.LENGTH_SHORT).show(); 


可 以 看 到 ， 我 们 在 MainActivity 中 定义 了 一 个 内 部 类 NetworkchangeReceiver 
这 个 类 是 继承 自 BroadcastReceiver 的 ， 并 重 写 了 父 类 的 onReceive() 方 
法 。 这 样 每 当 网 络 状态 发 生变 化 时 ，onReceive() 方法 就 会 得 到 执行 ， 这 里 
只 是 简单 地 使 用 Toast 提 示 了 一 段 文 本 信息 。 


给 它 添加 了 一 个 值 为 android.net.conn.CONNECTIVITY_CHANGE 的 action， 为 
什么 要 添加 这 个 值 呢 ?因为 当 网 络 状态 发 生变 化 时 ， 系 统 发 出 的 正 是 一 条 
值 为 android.net .conn.CONNECTIVITY_CHANGE 的 广播 ， 也 就 是 说 我 们 的 广播 
接收 需 想 要 监听 什么 广播 ， 就 在 这 里 添加 相应 的 action。 接 下 来 创建 了 一 个 
NetworkChangeReceiver 的 实例 ， 然 后 调用 registerReceiver() 方法 进行 注 
册 ， 将 NetworkchangeReceiver 的 实例 和 IntentFilter 的 实例 都 传 了 进去 ， 
这 样 NetworkchangeReceiver 束 会 收 到 所 有 值 为 


V 


android.net .conn.CONNECTIVITY_CHANGE 的 广播 ， 也 就 实现 了 监听 网 络 变化 
的 功能 。 


最 后 要 记得 ， 动 态 注 册 的 广播 接收 铬 一 定 都 要 取消 注册 才 行 ， 这 里 我 们 是 
在 onDestroy() 方法 中 通过 调用 unregisterReceiver() 方法 来 实现 的 > 


整体 来 说 ， 代 码 还 是 非常 简单 的 ， 现 在 运行 一 下 程序 。 首 先 你 会 在 注册 完 
成 的 时 候 收 到 一 条 广播 ， 然 后 按 下 Home 键 回 到 主 界面 (注意 不 能 按 Back 

键 ， 否则 onDestroy() on 接着 打开 Settings 程 序 -Data usage 进 
入 到 数据 使 用 详情 界面 ， 然 后 尝试 着 开关 Cellular data 按 钮 来 启动 和 禁用 网 
络 ， 你 就 会 看 到 有 Toast 提 醒 你 网 络 发 生 了 变 化 。 


不 过 ， 只 是 提醒 网 络 发 生 了 变化 还 不 够 人 性 化 ， 最 好 是 能 准确 地 告诉 用 户 
当前 是 有 网 络 还 是 没有 网 络 ， 因 此 我 们 还 需要 对 上 面 的 代码 进行 进一步 的 
优化 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


class NetworkChangeReceiver extends BroadcastReceiver { 


Q@Override 
public void onReceive(Context context, Intent intent) { 
ConnectivityManager connectionManager = (ConnectivityManager) 
getSystemService(Context.CONNECTIVITY_SERVICE); 
NetworkInfo networkInfo = connectionManager .getActiveNetworkInfo(); 
if (networkInfo != null && networkInfo.isAvailable()) { 
Toast.makeText(context, "network is available", 
Toast .LENGTH_SHORT) .show( ); 


} else { 
Toast.makeText(context, "network is unavailable", 
Toast .LENGTH_SHORT) .show( ); 


在 onReceive() 方法 中 ， 首 先 通 过 getsystemService( ) 方法 得 到 了 
ConnectivityManager 的 实例 ， 这 是 一 个 系统 服务 类 ， 专 门 用 于 管理 网 络 连 
接 的 。 从 然后 调用 它 的 getActiveNetworkInfo() 方法 可 以 得 到 NetworkInfo 的 
实例 ， ea hi ee 方法 ， 就 可 以 判断 出 当前 是 
否 有 了 网络 了 ， 最 后 我 们 还 是 通过 Toast 的 方式 对 用 户 进行 提示 。 


另外 ， 这 里 有 非常 重要 的 一 点 需要 说 明 ，Android 系 统 为 了 保护 用 户 设备 的 
安全 和 隐私 ， 做 了 严格 的 规定 : 如 果 程 序 需要 进行 一 些 对 用 户 来 说 比较 敏 
感 的 操作 ， 就 必须 在 配置 文件 中 声明 权限 才 可 以 ， 否 则 程序 将 会 直接 毅 
溃 。 比 如 这 里 访问 系统 的 网 络 状态 就 是 需要 声明 权限 的 。 打 开 
AndroidManifest.xml 文 件 ， 在 里 面 加 入 如 下 权限 就 可 以 访问 系统 网 络 状态 
了 本: 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<uses-permission android:name="android.permission.ACCESS_ NETWORK_STATE" /> 


</manifest> 


这 是 你 第 一 次 遇 到 权限 的 问题 ， 其 实 Android 中 有 许多 操作 都 是 需要 声明 权 


限 才 可 以 进行 的 ， 后 面 我 们 还 会 不 断 使 用 新 的 权限 。 不 过 目前 这 个 访问 系 

统 网 络 状 态 的 权限 还 是 比较 简单 的 ， 只 需要 在 AndroidManifest.xml 文 件 中 声 
明 一 下 就 可 以 了 ， 而 Android 6.0 系 统 中 引入 了 更 加 严格 的 运行 时 权限 ， 从 而 
能 够 更 好 地 保证 用 户 设 备 的 安全 和 隐私 ， 关 于 这 部 分 内 容 我 们 将 在 第 7 章 中 


学 习 。 


现在 重 狐 运行 程序 ， 然 后 按 下 Home 键 > Settings ~ Data usage， 进 入 到 数据 
使 用 详情 界面 ， 关 闭 Cellular data 会 弹出 无 网 络 可 用 的 提示 ， 如 图 5.3 所 示 。 
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图 5.3 禁用 系统 网 络 
然后 重新 打开 Cellular data 又 会 弹出 网 络 可 用 的 提示 ， 如 图 5.4 所 示 。 
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图 5.4 启用 系统 网 络 


5.2.2 静态 注册 实现 开机 启动 


动态 注册 的 广播 接收 器 可 以 目 由 地 控制 注册 与 注销 ， 在 灵活 性 方面 有 很 大 
的 优势 ， 但 是 它 也 存在 着 一 个 缺点 ， 即 必须 要 在 程序 局 动 之 后 才能 接收 到 
广播 ， 因 为 注册 的 逻辑 是 写 在 oncreate( ) 方法 中 的 。 那 么 有 没有 什么 办 法 
nn 
ed 


这 里 我 们 准备 让 程序 接收 一 条 开机 广播 ， 当 收 到 这 条 广播 时 就 可 以 在 
onReceive() 方法 里 执行 相应 的 逻辑 ， 从 而 实现 开机 启动 的 功能 。 可 以 使 用 
Android Studio 提 供 的 快捷 方式 来 创建 一 个 广播 接收 硕 ， 右 击 


com.example.broadcasttest 包 一 New 一 Other 一 Broadcast Receiver， 会 弹出 如 图 
5.5 所 示 的 窗口 。 


Geliiilelg el lol ld 


Android Studio 


Creates a new broadcast receiver component and adds it to your Android manifest. 


Class Name: BootCompleteReceiver 


Exported 


Enabled 


图 5.5 创建 广播 接收 器 的 窗口 


可 以 看 到 ， 这 里 我 们 将 广播 接收 器 命名 为 BootCompleteReceiver， Exported 
属性 表示 是 否 允 许 这 个 广播 接收 器 接收 本 程序 以 外 的 广播 ，Enabled 属性 表 
示 是 否 启 用 这 个 广播 接收 器 。 勾 选 这 两 个 属性 ， 点 击 Finish 完 成 创建 。 


然后 修改 BootCompleteReceiver 中 的 代码 ， 如 下 所 示 : 


public class BootCompleteReceiver extends BroadcastReceiver { 


Q@override 
public void onReceive(Context context, Intent intent) { 
Toast.makeText(context, "Boot Complete", Toast.LENGTH_LONG).show(); 


代码 非常 简单 ， 我 们 只 是 在 onReceive( ) 方法 中 使 用 Toast 弹 出 一 段 提示 信 
已 。 

另外 ， 静 态 的 广播 接收 器 一 定 要 在 AndroidManifest.xml 文 件 中 注册 才 可 以 使 
用 ， 不 过 由 于 我 们 是 使 用 Android Studio 的 快捷 方式 创建 的 广播 接收 器 ， 
此 注册 这 一 步 已 经 被 和 目 动 完 成 了 。 打 开 AndroidManifest,xml 文 件 瞧 一 瞧 ， 代 
码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<uses-permission android:name="android.permission.ACCESS_ NETWORK_STATE" /> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<receiver 
android:name=".BootCompleteReceiver" 
android:enabled="true" 
android:exported="true"> 
</receiver> 
</application> 


</manifest> 


可 以 看 到 ，<application> 标签 内 出 现 了 一 个 新 的 标签 <receiver> ， 所 有 静 
态 的 广播 接收 器 都 是 在 这 里 进行 注册 的 。 它 的 用 法 其 实 和 <activity> 标签 
非常 相似 ， 也 是 通过 android:name 来 指定 具体 注册 哪 一 个 广播 接收 器 ， 而 
enabled 和 exported 属性 则 是 根据 我 们 刚才 勾 选 的 状态 目 动 生成 的 。 


不 过 目前 BootCompleteReceiver 还 是 不 能 接收 到 开机 广播 的 ， 我 们 还 需要 对 
AndroidManifest.xml 文 件 进行 修改 才 行 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<uses-permission android:name="android.permission.ACCESS_ NETWORK_STATE" /> 
<uses-permission android:name="android.permission.RECEIVE_ BOOT_COMPLETED" /> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<receiver 
android:name=".BootCompleteReceiver" 
android:enabled="true" 
android:exported="true"> 
<intent-filter> 

<action android:name="android.intent.action.BOOT_COMPLETED" /> 

</intent-filter> 

</receiver> 

</application> 


</manifest> 


由 于 Android 系 统 启动 完成 后 会 发 出 一 条 值 为 
android,intent.action.BOOT_COMPLETED 的 广播 ， 因此 我 们 在 <intent - 
filter> 标签 里 添加 了 相应 的 action。 另 外 ， 监 听 系 统 开 机 广播 也 是 需要 声 


明 权 限 的 ， 可 以 看 到 ， 我 们 使 用 <uses-permission> 标签 又 加 入 了 一 条 


android.permission.RECEIVE_BOOT_COMPLETED 权限 。 


现在 重新 运行 程序 后 ， 我 们 的 程序 就 已 经 可 以 接收 开机 广播 了 。 将 模拟 器 
关闭 并 重新 启动， 在 局 动 完成 之 后 忠 会 收 到 开机 广播 ， 如 图 5.6 所 示 。 


Boot Complete 


:We We 


图 5.6 接收 系统 开机 广播 


到 目前 为 止 ， 我 们 在 广播 接收 器 的 onReceive( ) 方法 中 都 只 是 简单 地 使 用 

Toast 提 示 了 一 段 文本 信息 ， 当 你 真正 在 项 目 中 使 用 到 它 的 时 候 ， 束 可 以 在 
里 面 编 写 自 己 的 逻辑 。 需 要 注意 的 是 ， 不 要 在 onReceive() 方法 中 添加 过 多 
的 逻辑 或 者 进行 任何 的 耗 时 操作 ， 因 为 在 广播 接收 絮 中 是 不 允许 开启 线程 
的 ， 当 onReceive( ) 方法 运行 了 较 长 时 间 而 没有 结束 时 ， 程 序 就 会 报错 。 
此 广播 接收 器 更 多 的 是 扮演 一 种 打开 程序 其 他 组 件 的 角色 ， 比 如 创建 一 条 
或 者 启动 一 个 服务 等 ， 这 几 个 概念 我 们 会 在 后 面 的 章节 中 学 

|| 。 


5.3 ”发 送 目 定义 广播 


现在 你 已 经 学 会 了 通过 广播 接收 器 来 接收 系统 广播 ， 拉 下 来 我 们 束 要 学 习 
一 下 如 何在 应 用 程序 中 发 送 目 定义 的 广播 。 前 面 已 经 介绍 过 了 ， 广 播 主要 
分 为 两 种 类 型 :标准 广播 和 有 序 广播 ， 在 本 市 中 我 们 束 将 通过 实践 的 方式 
来 看 一 下 这 两 种 广播 具体 的 区 别 。 


5.3.1 ”发送 标准 广播 


在 发 送 广播 之 前 ， 我 们 还 是 需要 先 定义 一 个 广播 接收 器 来 准备 接收 此 广播 
才 行 ， 不 然 发 出 去 也 是 白 发 。 因 此 新 建 一 个 MyBroadcastReceiver， 代 码 如 
下 所 示 : 


public class MyBroadcastReceiver extends BroadcastReceiver { 


QOverride 
public void onReceive(Context context, Intent intent) { 
Toast.makeText(context, "received in MyBroadcastReceiver", Toast.LENGTH_ 
SHORT ) .Show() ， 


这 里 当 MyBroadcastReceiver 收 到 目 定 义 的 广播 时 ， 融 会 阐 出 “received in 
MyBroadcastReceiver” 的 提示 。 然 后 在 AndroidManifest.xml 中 对 这 个 广播 接 
收 硕 进行 修改 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<receiver 
android:name=" .MyBroadcastReceiver" 
android:enabled="true" 
android:exported="true"> 
<intent-filter> 

<action android:name="com.example.broadcasttest.MY_BROADCAST"/> 

</intent-filter> 

</receiver> 

</application> 
</manifest> 


可 以 看 到 ， 这 里 让 MyBroadcastReceiver 接 收 一 条 值 为 
com.example.broadcasttest.MY_BROADCAST 的 广播 ， 因 此 竺 会 儿 在 发 送 广播 
的 时 候 ， 我 们 就 需要 发 出 这 样 的 一 条 广播 。 


接 下 来 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<Button 
android:id="@+id/button" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 


android:text="Send Broadcast" 
/> 


</LinearLayout> 


改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedIinstanceState); 
setcontentView(R.1layout.activity_main); 
Button button = (Button) findViewById(R.id.button); 
button.setonClickListener(new View.OnClickListener() { 
Q@Override 
public void onClick(View v) { 
Intent intent = new 


Intent("com.example.broadcasttest.MY_BROADCAST" ); 
sendBroadcast (intent); 


可 以 看 到 ， 我 们 在 按钮 的 点 击 事件 里 面 加 入 了 发 送 自 定义 广播 的 逻辑 。 首 
先 构建 出 了 一 个 Intent 对 象 ， 并 把 要 发 送 的 广播 的 值 传 入 ， 然 后 调用 了 
Context 的 sendBroadcast() 方法 将 广播 发 送出 去 ， 这 样 所 有 监听 


com.example.broadcasttest.MY_BROADCAST 这 条 广播 的 广播 接收 姻 就 会 收 到 


消 妃 。 此 时 发 出 去 的 广播 就 是 一 条 标准 广播 。 
重新 运行 程序 ， 并 点 击 一 下 Send Broadcast 按 钮 ， 效 果 如 图 5.7 所 示 。 


BroadcastTest 


SEND BROADCAST 


received in MyBroadcastReceiver 


图 5.7 ”接收 到 目 定 义 广播 


这 样 我们 吏 成 功 完成 了 发 送 目 定 义 广播 的 功能 。 另 外 ， 由 于 广播 是 使 用 
Intent 进 行 传递 的 ， 因 此 你 还 可 以 在 Intent 中 携带 一 些 数据 传递 给 广播 接收 


局 已 


了 名? 


5.3.2 ”发 送 有 序 广播 


广播 是 一 种 可 以 跨 进 程 的 通信 方式 ， 这 一 点 从 前 面 接收 系统 广播 的 时 候 就 
可 以 看 出 来 了 。 因 此 在 我 们 应 用 程序 内 发 出 的 广播 ， 其 他 的 应 用 程序 应 该 
也 是 可 以 收 到 的 。 为 了 验证 这 一 点 ， 我 们 需要 再 新 建 一 个 BroadcastTest2 项 
目 ， 点 击 Android Studio 导 航 栏 ~File-New 一 New Project 进 行 创建 。 


将 项 目 创建 好 之 后 ， 还 需要 在 这 个 项 目下 定义 一 个 广播 接收 器 ， 用 于 接收 
上 一 小 节 新 建 AnotherBroadcastReceiver 代码 如 下 所 


人 小: 


public class AnotherBroadcastReceiver extends BroadcastReceiver { 


Q@Override 
public void onReceive(Context context, Intent intent) { 
Toast.makeText(context, "received in AnotherBroadcastReceiver", 
Toast .LENGTH_SHORT) .show( ); 


这 里 仍然 是 在 广播 接收 如 的 onReceive() 0 段 文本 信息 。 然 
在 AndroidManifest.xml 中 对 这 个 广播 接收 器 进行 修改 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest2"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<receiver 
android:name=".AnotherBroadcastReceiver" 
android:enabled="true" 
android:exported="true"> 
<intent-filter> 

<action android:name="com.example.broadcasttest.MY_BROADCAST" /> 

</intent-filter> 

</receiver> 

</application> 


</manifest> 


可 以 看 到 ，AnotherBroadcastReceiver 同 样 接收 的 是 
com.example.broadcasttest.MY_BROADCAST 这 条 广播 。 现 在 运行 
BroadcastTest2 项 目 将 这 个 程序 安装 到 模拟 器 上 ， 然 后 重 狐 回 到 BroadcastTest 
项 目的 主 界面 ， 并 点 击 一 下 Send Broadcast 按 钮 ， 就 会 分 别 弹 出 两 次 提示 信 
已， 如 图 5.8 所 示 。 


BroadcastTest 


BroadcastTest 


SEND BROADCAST SEND BROADCAST 


received in MyBroadcastReceiver received in AnotherBroadcastReceiver 


图 5.8 两 个 程序 中 都 接收 到 自 定义 广播 


这 样 就 强 有 力 地 证 明了 ， 我 们 的 应 用 程序 发 出 的 广播 是 可 以 被 其 他 的 应 用 
程序 接收 到 的 。 


不 过 到 目前 为 止 ， 程 序 里 发 出 的 都 还 是 标准 广播 ， 现 在 我 们 来 尝试 一 下 发 
送 有 序 广播 。 重 新 回 到 BroadcastTest 项 目 ， 然 后 修改 MainActivity 中 的 代 
码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


Q@Override 
protected void onCreate(Bundle SavedInstanceState) { 
Super ,onCreate(SavedInstanceState ) ; 
setcontentView(R.1layout.activity_main); 
Button button = (Button) findViewById(R.id.button); 
button.setOoncClickListener(new View.OnClickListener() { 
@Override 
public void onCclick(View v) { 
Intent intent = new 
Intent("com.example.broadcasttest.MY_BROADCAST" ); 


sendorderedBroadcast(intent, null); 


}); 


可 以 看 到 ， 发 送 有 序 广播 只 需要 改动 一 行 代 码 ， 即 将 sendBroadcast() 方法 
改 成 sendorderedBroadcast() 方法 。 sendorderedBroadcast() 方法 接收 两 个 
参数 ， 第 一 个 参数 仍然 是 Intent ， 第 二 个 参数 是 一 个 与 权限 相关 的 字符 
串 ， 这 里 传 入 null 就 行 了 。 现 在 重新 运行 程序 ， 并 点 击 Send Broadcast 按 
钮 ， 你 会 发 现 ， 两 个 应 用 程序 仍然 都 可 以 接收 到 这 条 广播 。 


看 上 去 好 像 和 标准 广播 没什么 区 别 哪 ， 不 过 别 起 了 ， 这 个 时 候 的 广播 接收 
絮 是 有 先后 顺序 的 ， 而 且 前 面 的 广播 接收 器 还 可 以 将 广播 截断 ， 以 阻止 其 
继续 传播 。 


那么 该 如 何 设 定 广播 接收 器 的 先后 顺序 昵 ? 当然 是 在 注册 的 时 候 进 行 设 定 
的 了 ， 修 改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest2"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<receiver 
android:name=".MyBroadcastReceiver" 


android:enabled="true" 
android:exported="true"> 
<intent-filter android:priority="100"> 
<action android:name="com.example.broadcasttest.MY_BROADCAST" /> 
</intent-filter> 


</receiver> 
</application> 


</manifest> 


可 以 看 到 ， 我 们 通过 android:priority 属性 给 广播 接收 器 设置 了 优先 级 ， 
优先 级 比较 高 的 广播 接收 器 束 可 以 先 收 到 广播 。 这 里 将 


MyBroadcastReceiver 的 优先 级 设 成 了 100， 以 保证 它 一 定 会 在 
AnotherBroadcastReceiver 之 前 收 到 广播 。 


既然 已 经 获得 了 接收 广播 的 优先 权 ， 那 么 MyBroadcastReceiver 就 可 以 选择 
是 否 允 许 广 播 继 续 传 递 了 。 修 改 MyBroadcastReceiver 中 的 代码 ， 如 下 所 
人 小: 


public class MyBroadcastReceiver extends BroadcastReceiver { 


QOverride 
public void onReceive(Context context, Intent intent) { 
Toast.makeText(context, "received in MyBroadcastReceiver", 
Toast .LENGTH_SHORT) .show( ); 
abortBroadcast(); 


如 果 在 onReceive( ) 方法 中 调用 了 abortBroadcast() 方法 ， 就 表示 将 这 条 广 
播 截断 ， 后 面 的 广播 接收 恬 将 无 法 再 接收 到 这 条 广播 。 现 在 重 狐 运行 程 
序 ， 并 点 击 一 下 Send Broadcast 按 钮 ， 你 会 发 现 ， 只 有 MyBroadcastReceiver 
中 的 Toast 信 息 能 够 弹出 ， 说 明 这 条 广播 经 过 MyBroadcastReceiver 之 后 确实 
是 终止 传递 了 。 


5.4 使 用 本 地 广播 


前 面 我 们 发 送 和 接收 的 广播 全 部 属于 系统 全 局 广播 ， 即 发 出 的 广播 可 以 被 
其 他 任何 应 用 程序 接收 到 ， 并 且 我 们 也 可 以 接收 来 目 于 其 他 任何 应 用 程序 
的 广播 。 这 样 吏 很 容易 引起 安全 性 的 问题 ， 比 如 说 我 们 发 送 的 一 些 携 市 头 
键 性 数据 的 广播 有 可 能 被 其 他 的 应 用 程序 截获 ， 或 者 其 他 的 程序 不 停 地 向 
我 们 的 广播 接收 侨 里 发 送 各 种 垃圾 广播 。 


为 了 能 够 简单 地 解决 广播 的 安全 性 问题 ，Android 引 入 了 一 套 本 地 广播 机 
制 ， 使 用 这 个 机 制 发 出 的 广播 只 能 够 在 应 用 程序 的 内 部 进行 传递 ， 并 且 广 
播 接收 器 也 只 能 接收 来 自 本 应 用 程序 发 出 的 广播 ， 这 样 所 有 的 安全 性 问题 
就 都 不 存在 了 。 


本 地 广播 的 用 法 并 不 复杂 ， 主 要 就 是 使 用 了 一 个 LocalBroadcastManager 来 对 
广播 进行 管理 ， 并 提供 了 发 送 广播 和 注册 广播 接收 器 的 方法 。 下 面 我 们 就 


通过 具体 的 实例 来 尝试 一 下 它 的 用 法 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 
人 小: 


public class MainActivity extends AppCompatActivity { 
private IntentFilter intentFilter,; 
private LocalReceiver localReceiver; 
private LocalBroadcastManager localBroadcastManager; 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
localBroadcastManager = LocalBroadcastManager .getInstance(this); // 获取 实例 
Button button = (Button) findViewById(R.id.button); 
button.setOoncClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent("com.example.broadcasttest.LOCAL_ 
BROADCAST" ) ， 
localBroadcastManager .sendBroadcast(intent); // 发 送 本 地 广播 


}); 

intentFilter = new IntentFilter(); 
intentFilter.addAction("com.example.broadcasttest .LOCAL_ BROADCAST" ) ， 
JocalReceiver = new LocalReceiver(); 

localBroadcastManager .registerReceiver(localReceiver, intentFilter); // 注 


册 本 地 广播 监听 器 


} 


QOverride 
protected void onDestroy() { 
super .onDestroy(); 
JocalBroadcastManager .unregisterReceiver(localReceiver); 


} 


class LocalReceiver extends BroadcastReceiver { 


Q@Override 
public void onReceive(Context context, Intent intent) { 
Toast.makeText(context, "received local broadcast", Toast.LENGTH_SHORT). 
show( ); 


有 没有 感觉 这 些 代码 很 熟悉 ? 没 错 ， 其 实 这 基本 上 束 和 我 们 前 面 所 学 的 动 
态 注 册 广 播 接 收回 以 及 发 送 广 播 的 代码 是 一 样 的 。 只 不 过 现在 首先 是 通过 
LocalBroadcastManagerl JgetInstance( ) 方法 得 到 了 它 的 一 个 实例 ， 然 后 在 
注册 广播 接收 器 的 时 候 调用 的 是 LocalBroadcastManager 的 
registerReceiver() 方法 ， 在 发 送 广播 的 时 候 调 用 的 是 


注 


LocalBroadcastManager 的 sendBroadcast() 方法 ， 仅 此 而 已 。 这 里 我 们 在 按 
钮 的 点 击 事件 里 面 发 出 了 一 条 com.example.broadcasttest .LOCAL_BROADCAST 
广播 ， 然 后 在 LocalReceiver 里 去 接收 这 条 广播 。 重 新 运行 程序 ， 并 点 击 Send 
Broadcast 按 钮 ， 歼 果 如 图 5.9 所 示 。 
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图 5.9 接收 到 本 地 广播 


可 以 看 到 ，LocalReceiver 成 功 接收 到 了 这 条 本 地 广播 ， 并 通过 Toast 提 示 了 
出 来 。 如 有 果 你 还 有 兴趣 进行 实验 ， 可 以 尝试 在 BroadcastTest2 中 也 去 接收 
com.example.broadcasttest.LOCAL BROADCAST 这 条 广播 。 答 案 是 显而易见 


的 ， 肯 定 无 法 收 到 ， 因 为 这 条 广播 只 会 在 BroadcastTest 程 序 内 传播 。 


另外 还 有 一 点 需要 说 明 ， 本 地 广播 是 无 法 通过 静态 注册 的 方式 来 接收 的 。 
其 实 这 也 完全 可 以 理解 ， 因 为 静态 注册 主要 驶 是 为 了 让 程序 在 未 局 动 的 情 
况 下 也 能 收 到 广播 ， 而 发 送 本 地 广播 时 ， 我 们 的 程序 肯定 是 已 经 启动 了 ， 
因此 也 完全 不 需要 使 用 静态 注册 的 功能 。 


最 后 我 们 再 来 盘点 一 下 使 用 本 地 广播 的 几 点 优势 吧 。 


。 可 以 明确 地 知道 正在 发 送 的 广播 不 会 离开 我 们 的 程序 ， 因 此 不 必 担 心 
机 密 数 据 汇 漏 。 


。 其 他 的 程序 无 法 将 广播 发 送 到 我 们 程序 的 内 部 ， 因 此 不 需要 担心 会 有 
安全 漏洞 的 隐患 。 


。 发 送 本 地 广播 比 发 送 系 统 全 局 广播 将 会 更 加 高 效 。 


5.5 “广播 的 最 佳 实践 一 一 实现 强制 下 线 
功能 


本 半 的 内 容 不 是 非常 多 ， 因 此 相信 你 也 一 定 学 得 很 轻松 吧 。 现 在 我 们 束 准 
备 通 过 一 个 完整 例子 的 实践 ， 来 综合 运用 一 下 本 章 中 所 学 到 的 知识 。 


强制 下 线 功 能 应 该 算是 比较 常见 的 了 ， 很 多 的 应 用 程序 都 具备 这 个 功能 ， 
比如 你 的 QQ 号 在 别处 登录 了 ， 就 会 将 你 强制 挤 下 线 。 其 实 实现 强制 下 线 功 
能 的 思路 也 比较 简单 ， 只 需要 在 界面 上 弹出 一 个 对 话 框 ， 让 用 户 无 法 进行 
任何 其 他 操作 ， 必 须要 点 击 对 话 框 中 的 确定 按钮 ， 人 然后 回 到 登录 界面 即 
可 。 可 是 这 样 就 存在 着 一 个 问题 ， 因 为 当 我 们 被 通知 需要 强制 下 线 时 可 能 
正 处 于 任何 一 个 界面 ， 难 道 需要 在 每 个 界面 上 都 编写 一 个 弹出 对 话 框 的 逻 
辑 ? 如 果 你 真 的 这 么 想 ， 那 思维 就 偏远 了 ， 我 们 完全 可 以 借助 本 章 中 所 学 
的 广播 知识 ， 来 非常 轻松 地 实现 这 一 功能 。 狐 建 一 个 BroadcastBestPractice 
项 目 ， 然 后 开始 动手 吧 。 


强制 下 线 功 能 需要 先 关 闭 掉 所 有 的 活动 ， 然 后 回 到 登录 界面 。 如 果 你 的 反 
应 足够 快 的 话 ， 应 该 会 想到 我 们 在 第 2 章 的 最 佳 实践 部 分 早 就 已 经 实现 过 关 
闭 所 有 活动 的 功能 了 ， 因 此 这 里 只 需要 使 用 同样 的 方案 即 可 。 先 创建 一 个 
Activitycollector 类 用 于 管理 所 有 的 活动 ， 代 码 如 下 所 示 : 


public class ActivityCollector { 


public static List<Activity> activities = new ArrayList<>(); 


public static void addActivity(Activity activity) { 
activities.add(activity); 


} 


public static void removeActivity(Activity activity) { 
activities.remove(activity); 


} 


public static void finishAl1L() { 
for (Activity activity : activities) { 
if (!activity.isFinishing()) { 
activity.finish(); 
} 


activities.clear(); 


然后 创建 BaseActivity 类 作为 所 有 活动 的 父 类 ， 代 码 如 下 所 示 : 


public class BaseActivity extends AppCompatActivity { 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
ActivityCollector.addActivity(this); 

} 


QOverride 

protected void onDestroy() { 
super .onDestroy(); 
ActivityCollector.removeActivity(this); 


以 上 代码 都 是 直接 拿 之 前 写 好 的 内 容 ， 非 党 开心 。 不 过 从 这 里 开始 ， 束 要 
靠 我 们 自己 去 动手 实现 了 。 首 先 需 要 创建 一 个 登录 界面 的 活动 ， 新 建 
LoginActivity， 并 让 Android Studio 帮 我 们 目 动 生成 相应 的 布局 文件 。 然 后 编 
辑 布局 文件 activity_ login.xml， 代 人 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<LinearLayout 

android:orientation="horizontal" 

android:layout_width="match_parent" 

android:layout_height="60dp"> 

<TextView 
android:layout_width="90dp" 
android:layout_height="wrap_content" 
android:layout_gravity="center_vertical" 
android:textSize="18sp" 
android:text="Account:" /> 


<EditText 
android:id="@+id/account" 


android:1layout_width="0odp" 

android:layout_height="wrap_content" 

android:layout_ weight="1" 

android:layout_gravity="center_vertical" /> 
</LinearLayout> 


<LinearLayout 

android:orientation="horizontal" 

android:layout_width="match_parent" 

android:layout_height="60dp"> 

<TextView 
android:layout_ width="90dp" 
android:layout_height="wrap_content" 
android:layout_gravity="center_vertical" 
android:textSize="18sp" 
android:text="Password:" /> 


<EditText 
android:id="@+id/password" 
android:layout_width="QOdp" 
android:layout_height="wrap_content" 
android:layout_weight="1" 
android:layout_gravity="center_vertical" 
android:inputType="textPassword" /> 
</LinearLayout> 


<Button 
android:id="@+id/login" 
android:layout_width="match_parent" 
android:layout_height="60dp" 
android:text="Login" /> 


</LinearLayout> 


这 里 我 们 使 用 LinearLayout 编 写 出 了 一 个 登录 布局 ， 最 外 层 是 一 个 纵 同 的 


LinearLayout， 里 面包 含 了 3 行 直接 子 元 素 。 第 一 行 是 一 个 横 回 
LinearLayout， 用 于 输入 账号 信息 ; 第 二 行 也 是 一 个 横 回 的 LinearLayout， 用 
于 输入 密码 信息 ; 第 三 行 是 一 个 登录 按钮 。 这 个 布局 文件 里 面 用 到 的 全 部 
都 是 我 们 之 前 学 过 的 内 容 ， 相 信 你 理解 起 来 应 该 不 会 费劲 。 


接 下 来 修改 LoginActivity 中 的 代码 ， 如 下 所 示 : 


public class LoginActivity extends BaseActivity { 


private EditText accountEdit,; 
private EditText passwordEdit; 
private Button login; 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setCcontentView(R.1layout.activity_login),; 
accountEdit = (EditText) findViewById(R.id.account); 
passwordEdit = (EditText) findViewById(R.id.password); 
lJogin = (Button) findViewById(R.id.1ogin); 


Jogin.setOonClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
String account = accountEdit.getText().toSstring(); 
String password = passwordEdit.getText().toString(); 
// 如 果 账 号 是 admin 且 密码 是 123456， 就 认为 登录 成 功 
if (account .equals("admin") && password.equals("123456")) { 
Intent intent = new Intent(LoginActivity.this, MainActivity. 
class); 
startActivity(intent); 
finish(); 
} else { 
Toast.makeText(LoginActivity.this, "account or password is 
invalid", Toast.LENGTH_SHORT).show!(); 


这 里 我 们 模拟 了 一 个 非常 简单 的 登录 功能 。 首 先 要 将 LoginActivity 的 继承 结 
构 改 成 继承 自 BaseActivity， 然 后 调用 findviewById() 方法 分 别 获取 到 账号 
输入 框 、 密 码 输 入 框 以 及 登录 按钮 的 实例 。 接 着 在 登录 按钮 的 点 击 事件 里 
面 对 输入 的 账号 和 密码 进行 判断 ， 如 果 账 号 是 admin 并 且 密 码 是 123456， 就 
认为 登录 成 功 并 跳 转 到 MainActivity， 人 否则 束 提 示 用 户 账 号 或 密码 错误 。 


因此 ， 你 就 可 以 将 MainActivity 理 解 成 是 登录 成 功 后 进入 的 程序 主 界面 了 ， 
这 里 我 们 并 不 需要 在 主 界面 里 提供 什么 花哨 的 功能 ， 只 需要 加 入 强制 下 线 
功能 就 可 以 了 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<Button 
android:id="@+id/force_offline" 
android:layout_width="match_parent" 


android:layout_height="wrap_content" 
android:text="Send force offline broadcast" /> 


</LinearLayout> 


非常 简单 ， 只 有 一 个 按钮 而 已 ， 用 于 触发 强制 下 线 功 能 。 然 后 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends BaseActivity { 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
Super .oncCreate(SavedInstanceState ) 
SetContentView(R. layout,activity_main) ， 
Button forceoffline = (Button) findViewById(R,.id,.force_offline)， 
forceoffline.setOonclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent("com.example.broadcastbestpractice. 
FORCE_OFFLINE"”) ， 
sendBroadcast(intent); 


}); 


同样 非常 简单 ， 不 过 这 里 有 个 重点 ， 我 们 在 按钮 的 点 击 事件 里 面 发 送 了 一 


广播 的 值 为 com.example.broadcastbestpractice.FORCE_OFFLINE ， 


条 广播 就 是 用 于 通知 程序 强制 用 户 下 线 的 。 世 束 是 说 强制 用 户 下 线 的 逻 
给 并 不 年 与信 MainActivity 里 的 ， 而 是 应 该 写 在 接收 这 条 广播 的 广播 接收 器 
里 面 ， 这 样 强 制 下 线 的 功 EB 束 不 会 依附 于 任何 的 界面 ， 不 管 是 在 程序 的 任 
何 地 方 ， 只 需要 发 出 这 样 一 条 广播 ， 就 可 以 完成 强制 下 线 的 操作 了 。 


那么 毫 无 疑问 ， 接 下 来 我 们 束 需 要 创建 一 个 广播 接收 器 来 接收 这 条 强制 下 
线 广播 ， 唯 一 的 问题 就 是 ， 应 该 在 哪里 创建 呢 ? 由 于 广播 接收 器 里 面 需要 
弹出 一 个 对 话 框 来 阻塞 用 户 的 正常 操作 ， 但 如 果 创 建 的 是 一 个 静态 注册 的 
广播 接收 器 ， 是 没有 办 法 在 onReceive( ) 方法 里 弹出 对 话 杠 这样 的 UI 控件 
的 ， 而 我 们 显 然 也 不 可 能 在 每 个 活动 中 都 去 注册 一 个 动态 的 广播 接收 费 


那么 到 底 应 该 怎么 办 呢 ? 答案 其 实 很 明显 ， 只 需要 在 BaseActivity 中 动态 注 
册 一 个 广播 接收 絮 就 可 以 了 ， 因 为 所 有 的 活动 都 是 继承 目 BaseActivity 的 。 


修改 BaseActivity 中 的 代码 ， 如 下 所 示 : 


public class BaseActivity extends AppCompatActivity { 


private ForceofflineReceiver receiver; 


Q@Override 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedIinstanceState); 
ActivityCollector.addActivity(this); 

} 


QOverride 

protected void onResume() { 
super .onResume(); 
IntentFilter intentFilter = new IntentFilter(); 
intentFilter.addAction("com.example.broadcastbestpractice.FORCE_ OFFLINE"); 


receiver = new ForceOfflineReceiver(); 
registerReceiver(receiver, intentFilter); 


} 


QOverride 


protected void onPause() { 
super .onpause( ); 


if (receiver 


1!= nu1l1) { 


unregisterReceiver(receiver); 


receiver 


} 


Q@Override 


= null; 


protected void onDestroy() { 
super .onDestroy(); 
ActivityCollector.removeActivity(this); 


} 


class ForceOofflineReceiver extends BroadcastReceiver { 


Q@Override 


public void onReceive(final Context context, Intent intent) { 
AlertDialog.Builder builder = new AlertDialog.Builder(context); 
builder.setTitle("Warning"); 
builder.setMessage("You are forced to be offline. Please try to login 
again."); 
builder.setCancelable(false); 
builder.setPositiveButton("OK", new DialogInterface.OnClickListener() { 
QOverride 
public void onClick(DialogInterface dialog, int which) { 
ActivityCcollector .finishAl1()， // 销毁 所 有 活动 
Intent intent = new Intent(context, LoginActivity.class); 
context ,startActivity(intent); // 重新 启动 LoginActivity 


} 


); 
builder .show( ); 


先 来 看 一 下 ForceOfflineReceiver 中 的 代码 ， 这 次 onReceive() 方法 里 可 不 再 


是 仅仅 弹出 一 个 Toast 了， 而 是 加 入 了 较 多 的 代码 ， 那 我 们 就 来 仔细 地 看 看 
吧 。 首 先 肯定 是 使 用 Alertpialog.Builder 来 构建 一 个 对 话 框 ， 注 意 这 里 一 
定 要 调用 setcancelable() 方法 将 对 话 框 设 为 不 可 取消 ， 否 则 用 户 按 一 下 

Back 键 玖 可 以 关闭 对 话 框 继续 使 用 程序 了 。 然 后 使 用 setpPositiveButton( ) 


方法 来 给 对 话 框 六 


FE 册 确定 按钮 ， 当 用 户 点 击 了 确定 按钮 时 ， 束 调用 


ActivityCollector 的 finishA11( ) 方法 来 销毁 掉 所 有 活动 ， 并 重新 局 动 
LoginActivity 这 个 活动 。 


再 来 看 一 下 我 们 是 怎么 注册 ForceOfflineReceiver 这 个 广播 接收 器 的 ， 可 以 看 


到 ， 这 里 重 写 了 onResume() 和 onPause() 这 两 个 生命 周期 国 数 ， 然 后 分 别 在 


这 两 个 方法 里 注册 和 取消 注册 了 ForceOfflineReceiver 。 


那么 为 什么 要 这 样 写 呢 ? 之 前 不 都 是 在 oncreate() 和 onDestroy() 方法 里 来 
注册 和 取消 注册 广播 接收 器 的 么 ? 这 是 因为 我 们 始终 需要 保证 只 有 处 于 栈 
顶 的 活动 才能 接收 到 这 条 强制 下 线 广播 ， 非 栈 顶 的 活动 不 应 该 也 没有 必要 
去 接收 这 条 广播 ， 所 以 写 在 onResume() 和 onPause() 方法 里 就 可 以 很 好 地 人 解 
9 当 一 个 活动 失去 栈 顶 位 置 时 就 会 自动 取消 广播 接收 器 的 注 


这 样 的话 ， 所 有 强制 下 线 的 逻辑 就 已 经 完成 了 ， 接 下 来 我 们 还 需要 对 
AndroidManifest.xml 文 件 进 行 修 改 ， 代 码 如 下 所 示 : 


H 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcastbestpractice"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity android:name=" .MainActivity"> 
</activity> 
<activity android:name=" .LoginActivity"> 
<intent-filter> 
<action android:name="android,.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


这 里 只 需要 对 一 处 代码 进行 修改 ， 就 是 将 主 活动 设置 为 LoginActivity 而 不 再 
征 MainActivity， 因 为 你 肯定 不 硕 望 用 户 在 没 登 孙 的 情况 下 束 能 直接 进入 到 
程序 主 界面 吧 ? 


好 了 ， 现 在 来 莹 试 运行 一 下 程序 吧 ， 首 移 会 进入 到 登录 弄 面 ， 并 可 以 在 这 
里 输入 账号 和 和 密码， 如 图 5.10 所 示 。 


BroadcastBestPractice 


Account: admin 


3SSWOrd rrres 


图 5.10 登录 界面 


如 果 输 入 的 账号 是 admin， 密 码 是 123456， 点 击 登 录 按钮 就 会 进入 到 程序 的 
主 界面 ， 如 图 5.11 所 示 。 这 时 点 击 一 下 发 送 广播 的 按钮 ， 允 会 发 出 一 条 强制 
下 线 的 广播 ，ForceOfflineReceiver 里 收 到 这 条 广播 后 会 弹出 一 个 对 话 框 提示 
用 户 已 被 强制 下 线 ， 如 图 5.12 所 示 。 
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SEND FORCE OFFLINE BROADCAST 


图 5.11 主 界面 


Warning 


You are forced to be offline. Please try to 


login again 


OK 


图 5.12 强制 下 线 提示 


这 时 用 户 将 无 法 再 对 界面 的 任何 元 素 进 行 操作 ， 只 能 点 击 确定 按钮 ， 然 后 
会 重新 回 到 登录 界面 。 这 样 ， 强 制 下 线 功 能 整 已 经 完整 地 实现 了 。 


结束 了 本 章 的 最 佳 实践 部 分 ， 接 下 来 我 们 要 进入 一 个 特殊 的 环卫 。 相 信 你 
一 定 也 知道 ， 几 乎 所 有 出 色 的 项 目 都 不 会 是 由 一 个 人 单枪匹马 完成 的 ， 而 
是 由 一 个 团队 共同 合作 开发 完成 的 。 这 个 时 候 多 人 之 间 代 码 同 步 的 问题 就 
显得 异常 重要 ， 因 此 版 本 控制 工具 也 就 应 运 而 生 了 。 常 见 的 版 本 控制 工具 
主要 有 svn 和 Git， 本 书 中 将 会 对 Git 的 使 用 方法 进行 全 面 的 讲解 ， 并 且 讲 解 
ee 些 音节 当中 的 。 那 么 今天 ， 我 们 就 先 来 看 一 看 关于 Git 最 
A 用法。 


5.6 ”Git 时 间 一 一 初 识 版 本 控制 工具 


Git 是 一 个 开源 的 分 布 式 版 本 控制 工具 ， 它 的 开发 者 加 是 己见 大 名 的 Linux 操 
作 系 统 的 作者 Linus Torvalds。Git 和 被 开发 出 来 的 初衷 是 为 了 更 好 地 管理 Linux 
内 核 ， 而 现在 却 早 已 被 广泛 应 用 于 全 球 各 种 大 中 小 型 的 项 目 中 。 今 天 是 我 
ee 主要 是 讲解 一 下 它 最 基本 的 用 法 ， 那 么 就 从 安装 Git 
开始 吧 。 


5.6.1 ”安装 Git 


由 于 Git 和 Linux 操 作 系 统 都 是 同一 个 作者 ， 因 此 不 用 我 说 ， 你 也 应 该 猜 到 
Git 在 Linux 上 的 安装 是 最 简单 方便 的 。 比 如 你 使 用 的 是 Ubuntu 系统 ， 只 需要 
打开 shell 界 面 ， 并 输入 : 


sudo apt-get install git-core 


按 下 回 车 后 输入 密码 ， 即 可 完成 Git 的 安装 。 


不 过 我 相信 你 更 有 可 能 使 用 的 还 是 Windows 操 作 系 统 ， 因 此 本 小 节 的 重点 是 
教会 你 如 何在 Windows 上 安装 Git。 不 同 于 Linux，Windows 上 可 无 法 通过 一 
行 命 令 就 完成 安装 了 ， 我 们 需要 先 把 Git 的 安装 包 下 载 下 来 。 访 问 网 址 
https://git-for-windows.github.io/ ， 可 以 看 到 如 图 5.13 所 示 的 页 面 。 


" 
git for windows FAQ 


图 5.13 gitfor windows 主 页 


目前 最 新 的 git for windows 版 本 是 2.8.1， 我 就 准备 使 用 这 一 版 本 了 ， 如 果 你 
下 载 的 时 候 发 现 义 有 新 的 版 本 ， 可 以 尝试 一 下 最 新 版 本 的 Git。 点 击 
Download 按 钮 可 以 开始 下 载 ， 下 载 完 成 后 双击 安装 包 进 行 安 装 ， 之 后 一 直 
点 击 “ 下 一 步 ” 就 可 以 完成 安装 了 。 


5.6.2 ”创建 代码 仓库 


虽然 在 Windows 上 安装 的 Git 是 可 以 在 图 形 界面 上 进行 操作 的 ， 并 日 Android 
Studio 也 支持 以 图 形 化 的 形式 操作 Git， 但 是 这 里 我 并 不 建议 你 这 样 做 ， 因 
为 Git 的 各 种 命令 才 是 你 应 该 掌握 的 核心 技能 ， 不 管 你 是 在 哪个 操作 系统 

中 ， 使 用 命令 来 操作 Git 肯 定 都 是 通用 的 。 而 图 形 化 的 操作 应 该 是 在 你 能 熟 
练 掌握 命令 用 法 的 前 提 下 ， 进 一 步 提 升 你 工作 效率 的 手段 。 


那么 我 们 现在 就 来 尝试 一 下 如 何 通 过 命令 来 使 用 Git。 如 果 你 使 用 的 是 Linux 
系统 ， 就 先 打开 shell 界 面 ， 如 果 使 用 的 是 Windows 系 统 ， 就 从 开始 里 找到 
Git Bash 并 打开 。 


首先 应 该 配置 一 下 你 的 号 份 ， 这 样 在 提交 代码 的 时 候 Git 吕 可 以 知道 是 谁 提 
交 的 了 ， 命 令 如 下 所 示 : 


git config --global user.name "Tony" 
git config --global user.email "tony@gmail.com" 


配置 完成 后 你 还 可 以 使 用 同样 的 命令 来 查看 是 否 配置 成 功 ， 只 需要 将 最 后 
的 名 了 字 和 邮箱 地 址 去 挥 即 可 ， 如 图 5.14 所 示 。 


图 5.14 查看 git 用 户 名 和 邮箱 


然后 我 们 就 可 以 开始 创建 代码 仓库 了 ， 仓 库 (Repository) 是 用 于 保存 版 本 
管理 所 需 信 息 的 地 方 ， 所 有 本 地 提交 的 代码 都 会 被 提交 到 代码 仓库 中 ， 如 
果 有 需要 还 可 以 再 推送 到 远程 仓库 中 。 


这 里 我 们 党 试 着 给 BroadcastBestPractice 项 目 建 立 一 个 代码 仓库 。 先 进入 到 
BroadcastBestPractice 项 目的 目录 下 面 ， 如 图 5.15 所 示 。 


| Users/Administrator/AndroidSstudioProjects/BroadcastBestPractice 


图 5.15 切换 到 BroadcastBestPractice 项 目 目录 下 
然后 在 这 个 目录 下 面 输入 如 下 命令 


git init 


很 简单 吧 ! 只 需要 一 行 命令 束 可 以 完成 创建 代码 仓库 的 操作 ， 如 图 5.16 所 
太 ° 


$ git 1n1t 


Initialized empty Git repository in C:/Users/Administrator/AndroidstudioProjects 
BroadcastBestPractice/.git 


图 5.16 创建 代码 仓库 


仓库 创建 完成 后 ， 会 在 BroadcastBestPractice 项 目的 根 目 孙 下 生成 一 个 人 
的 .git 文 件 来， 这 个 文件 夹 就 是 用 来 记录 本 地 所 有 的 Git 探 作 的 ， 可 以 通 
-al 命令 来 查看 一 下 ， 如 图 5.17 所 示 。 
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图 5.17 查看 .git 文 件 
如 果 你 想 要 删除 本 地 仓库 ， 只 需要 删除 这 个 文件 夹 就 行 了 。 


5.6.3 ”提交 本 地 代码 


代码 仓库 建立 完 之 后 束 可 以 提交 代码 了 ， 其 实 提 交代 码 的 方法 也 非常 简 
单 ， 只 需要 使 用 add 和 commit 命令 就 可 以 了 。add 用 于 把 想 要 提交 的 代码 先 
添加 进来 ， 而 commit 则 是 真正 地 去 执行 提交 操作 。 比 如 我 们 想 添 加 
build.gradle 文 件 ， 束 可 以 输入 如 下 命令 : 


git add build.gradle 


这 是 添加 单个 文件 的 方法 ， 那 如 果 我 们 想 添 加 某 个 目录 呢 ? 其 实 只 需要 在 
add 后 面 加 上 目录 名 就 可 以 了 。 比 如 将 整个 app 目 录 下 的 所 有 文件 都 进行 添 
加 ， 束 可 以 输入 如 下 命令 : 


git add app 


可 是 这 样 一 个 个 地 添加 感觉 还 是 有 些 复杂 ， 有 没有 什么 办 法 可 以 一 次 性 就 
巴 所 有 的 文件 都 添加 好 呢 ?” 当 然 可 以 ， 只 需要 在 aqd 的 后 面 加 上 一 个 点 ， 就 
表示 添加 所 有 的 文件 了 ， 命 令 如 下 所 示 : 


现在 BroadcastBestPractice 项 目下 所 有 的 文件 都 已 经 添加 好 了 ， 我 们 可 以 来 
提交 一 下 了 ， 输 入 如 下 命令 : 


git commit -m "First commit." 


， 在 commit 命令 的 后 面 ， 我 们 一 定 要 通过 -m 参数 来 加 上 提交 的 描述 信 
居 ， 没 有 描述 信息 的 提交 被 认为 是 不 合法 的 。 这 样 所 有 的 代码 就 已 经 成 功 


pr 


一 <. 
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提交 了 | 


好 了 ， 关 于 Git 的 内 容 ， 今 天 我 们 就 学 到 这 里 ， 虽然 内 容 并 不 多 ， 但 是 你 已 

经 将 Git 最 基本 的 用 法 都 掌握 了 ， 不 是 吗 ? 在 本 书后 面 的 章节 ， 还 会 穿插 一 
些 Git 的 讲解 ， 到 时 候 你 将 学 会 更 多 关于 Git 的 使 用 技巧 ， 现 在 就 让 我 们 来 总 
结 一 下 吧 。 


5.7 小结 与 点 评 


本 章 中 我 们 主要 是 对 Android 的 广播 机 制 进行 了 深入 的 研究 ， 不 仅 了 解 了 广 
播 的 理论 知识 ， 还 掌握 了 接收 广播 、 发 送 目 定 义 广 播 以 及 本 地 广播 的 使 用 
方法 。 广 播 接 收 絮 属于 Android 四 大 组 件 之 一 ， 在 不 知 不 觉 中 你 已 经 掌握 了 
四 大 组 件 中 的 两 个 了 。 


在 最 佳 实践 环节 中 你 一 定 也 收获 了 不 少 ， 不 仅 运用 到 了 本 章 所 学 的 广播 知 
识 ， 还 将 前 面 草 市 所 学 到 的 技巧 绿 合 运用 到 了 一 起 。 经 过 这 个 例子 之 后 ， 
相信 你 对 所 涉及 的 每 个 知识 点 都 有 了 更 深 一 层 的 认识 。 男 外 ， 本 章 还 添加 
了 一 个 最 最 特殊 的 环节 ， 即 Git 时 间 。 在 这 个 环节 中 ， 我 们 对 Git 这 个 版 本 挥 
制 工 具 进行 了 初步 的 学 习 ， 后 面 还 会 学 习 关 于 它 的 更 多 内 容 。 


下 一 章 我 们 本 应 该 继续 学 习 Android 四 大 组 件 中 的 内 容 提供 器 ， 不 过 由 于 学 
习 内 容 提 供 器 之 前 需要 先 掌 握 Android 中 的 持久 化 技术 ， 因 此 下 一 章 我 们 就 
先 对 这 一 主题 展开 讨论 。 


第 6 章 数据 存储 全 方案 - 详解 振 
久 化 技术 


任何 一 个 应 用 程序 ， 其 实说 日 了 就 是 在 不 停 地 和 数据 打交道 ， 我 们 聊 QQ、 
看 新 闻 、 刷 微 博 ， 所 关心 的 都 征 里 面 的 数据 ， 没 有 数据 的 应 用 程序 束 变 成 
了 一 个 空 膏 子 ， 对 用 户 来 说 没有 任何 实际 用 途 。 那 么 这 些 数据 都 是 从 哪 来 
的 呢 ? 现在 多 数 的 数据 基本 都 是 由 用 户 产 生 的 ， 比 如 你 发 微 博 、 评 论 新 
闻 ， 其 实 都 是 在 产生 数据 。 


而 我 们 前 面 章节 所 编写 的 众多 例子 中 也 有 用 到 各 种 各 样 的 数据 ， 例 如 第 3 章 
最 佳 实践 部 分 在 聊天 界面 编写 的 聊天 内 容 ， 第 5 章 最 佳 实践 部 分 在 登录 界面 
输入 的 账号 和 密码 。 这 些 数据 都 有 一 个 共同 点 ， 即 它们 都 属于 瞬时 数据 。 
那么 什么 是 瞬时 数据 呢 ? 束 是 指 那些 存储 在 内 存 当 中 ， 有 可 能 会 因为 程序 
关闭 或 其 他 原因 导致 内 存 补 回收 而 丢失 的 数据 。 这 对 于 一 些 关 键 性 的 数据 
信息 来 说 是 绝对 不 能 容 恕 的 ， 谁 都 不 希望 目 己 刚 发 出 去 的 一 条 微 博 ， 刷 新 
一 下 惑 没 了 吧 。 那 么 怎样 才能 保证 一 些 关 键 性 的 数据 不 会 丢失 呢 ? 这 就 需 
要 用 到 数据 持久 化 技术 了 。 


6.1 持久 化 技术 简介 


数据 持久 化 就 是 指 将 那些 内 存 中 的 瞬时 数据 保存 到 存储 设备 中 ， 保 证 即使 
在 手机 或 电脑 天 机 的 情况 下 ， 这 些 数据 仍然 不 会 丢失 。 保 存在 内 存 中 的 数 
据 是 处 于 瞬时 状态 的 ， 而 保存 在 存储 设备 中 的 数据 是 处 于 持久 状态 的 ， 持 
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持久 化 技术 被 广泛 应 用 于 各 种 程序 设计 的 领域 当中 ， 而 本 书 中 要 探讨 的 目 
然 直 Android 中 的 数据 持 信 化 技术 。 Android 系 统 中 主要 提供 了 3 种 方式 用 于 
简单 地 实现 数据 持久 化 功能 ， 即 文件 存储 、SharedPreferences 存 储 以 及 数据 
库存 储 。 当 然 ， 除 了 这 3 种 方式 之 外 ， 你 还 可 以 将 数据 保存 在 手机 的 SD 卡 
中 ， 不 过 使 用 文件 、SharedPreferences 或 数据 库 来 保存 数据 会 相对 更 简单 一 
些 ， 而 且 比 起 将 数据 保存 在 SD 卡 中 会 更 加 地 安全 。 


那么 下 面 我 束 将 对 这 3 种 数据 持久 化 的 方式 一 一 进行 评 细 的 讲解 。 


6.2 ”文件 存储 


文件 存储 是 Android 中 最 基本 的 一 种 数据 存储 方式 ， 它 不 对 存储 的 内 容 进行 
任何 的 格式 化 处 理 ， 所 有 数据 都 是 原封 不 动 地 保存 到 文件 当中 的 ， 因 而 它 
比较 适合 用 于 存储 一 些 简 单 的 文本 数据 或 二 进 制 数据 。 如 末 你 想 使 用 文件 
存储 的 方式 来 保存 一 些 较为 复杂 的 文本 数据 ， 就 需要 定义 一 套 上 自己 的 格式 
规范 ， 这 样 可 以 方便 之 后 将 数据 从 文件 中 重新 解析 出 来 。 


那么 首先 我 们 就 来 看 一 看 ，Android 中 是 如 何 通过 文件 来 保存 数据 的 。 


6.2.1 将 数据 存储 到 文件 中 


context 类 中 提供 了 一 个 openFileoutput() 方法 ， 可 以 用 于 将 数据 存储 到 
定 的 文件 中 。 这 个 方法 接收 两 个 参数 ， 第 一 个 参数 是 文件 名 ， 在 文件 创建 
的 时 候 使 用 的 就 是 这 个 名 称 ， 注 意 这 里 指定 的 文件 名 不 可 以 包含 路 径 ， 因 
为 所 有 的 文件 都 是 默认 存储 到 /data/data/<package name>/files/ 目 录 下 的 。 第 
二 个 参数 是 文件 的 操作 模式 ， 主 要 有 两 种 模式 可 选 ，MODE_PRIVATE 和 
MODE_APPEND。 其 中 MODE_PRIVATE 是 默认 的 操作 模式 ， 表 示 当 指定 同 
样 文件 名 的 时 候 ， 所 写 入 的 内 容 将 会 覆盖 原文 件 中 的 内 容 ， 而 
MODE_APPEND 则 表示 如 果 该 文件 已 存在 ， 束 往 文件 里 面 追 加 内 容 ， 不 存 
在 就 创建 新 文件 。 其 实 文件 的 操作 模式 本 来 还 有 另外 两 种 : 

MODE WORLD_ READABLE 和 MODE WORLD WRITEABLE， 这 两 种 模 
式 表示 人 允许 其 他 的 应 用 程序 对 我 们 程序 中 的 文件 进行 读 写 操作 ， 不 过 由 于 
i 
中 被 废弃 。 


openFileOutput () 方法 返回 的 是 一 人 FileOutputStream 对 象 ， 得 到 了 这 个 
对 象 之 后 束 可 以 使 用 Java 流 的 方式 将 数据 写 入 到 文件 中 了 。 以 下 是 一 段 简单 
的 代码 示例 ， 展 示 了 如 何 将 一 段 文本 内 容 保 存 到 文件 中 : 


public void save() { 
String data = "Data to save"; 
FileOutputStream out = null; 
Bufferedwriter writer = null; 
try { 
out = openFileOutput("data", Context.MODE_ PRIVATE); 
writer = new Bufferedwriter(new OutputStreamWwriter(out)); 
writer.write(data); 
} catch (IOException e) { 
e.printStackTrace( ); 
} finally { 
try { 
if (writer != null) { 
writer.close( ); 


ly 


} 
} catch (IOException e) { 
e,printStackTrace( ); 


如 果 你 已 经 比较 熟悉 Java 流 了 人， 理解 上 面 的 代码 一 定 轻 而 易 举 吧 。 这 里 通过 
openFileOutput() 方法 能 够 得 到 一 广 FIJeoutputStream 对 象 ， 然后 再 借助 它 
构建 出 一 人 OutputStreamWriter 对 象 ， 接着 再 使 用 outputstreamwriter 构建 


出 一 个 Bufferedwriter 对 象 ， 这 样 你 加 可 以 通过 Bufferedwriter 来 将 文本 
内 容 写 入 到 文件 中 了 。 


下 面 我 们 就 编写 一 个 完整 的 例子 ， 借 此 学 习 一 下 如 何在 Android 项 目 中 使 用 
文件 存储 的 技术 。 首 先 创建 一 个 FilePersistenceTest 项 目 ， 并 修改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<EditText 
android:id="@+id/edit" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:hint="Type something here" 
/> 


</LinearLayout> 


me 其 实现 在 你 就 
训 以 运行 一 下 程序 界面 上 肯定 会 有 一 个 文本 输入 框 。 然后 在 文本 输入 
1 再 按 下 Back 键 ， 这 时 输入 的 内 容 肯 定 了 加 已 经 丢 
失 了 ， 因 为 它 只 是 瞬时 数据 ， 在 活动 被 销毁 后 就 会 被 回收 。 而 这 里 我 们 要 
做 的 ， 就 是 在 数据 被 回收 之 前 ， 将 它 存储 到 文件 当中 。 修改 MainActivity 中 
的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private EditText edit; 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
edit = (EditText) findViewById(R.id.edit); 

} 


Q@Override 

protected void onDestroy() { 
super .onDestroy(); 
String inputText = edit.getText().toString(); 
save(inputText); 


} 


public void save(String inputText) { 
FileOutputStream out = null; 
Bufferedwriter writer = null; 
try { 
out = openFileOutput("data", Context.MODE_ PRIVATE); 
writer = new Bufferedwriter(new OutputStreamwriter(out)); 


writer.write(inputText); 
} catch (IOException e) { 
e,printStackTrace( ); 
} finally { 
try { 
if (writer != null) { 
writer.closel( ); 


} 
} catch (IOException e) { 
e.printStackTrace( ); 


可 以 看 到 ， 首 先 我 们 在 oncreate() 方法 中 获取 了 EditText 的 实例 ， 然 后 重 写 


了 onpestroy() 方法 ， 这 样 就 可 以 保证 在 活动 销毁 之 前 一 定 会 调用 这 个 方 
法 。 在 onpestroy( ) 方法 中 我 们 获取 了 EditText 中 输入 的 内 容 ， 并 调用 save() 
方法 把 输入 的 内 容 存 储 到 文件 中 ， 文 件 命 名 为 data。save( ) 方法 中 的 代码 和 
之 前 的 示例 基本 相同 ， 这 里 就 不 再 做 解释 了 。 现 在 重新 运行 一 下 程序 ， 并 
在 EditText 中 输入 一 些 内 容 ， 如 图 6.1 所 示 。 


FilePersistenceTest 


Content 


图 6.1 在 EditText 中 随意 输入 点 内 容 


然后 按 下 Back 键 关闭 程序 ， 这 时 我 们 输入 的 内 容 就 已 经 保存 到 文件 中 了 。 
那么 如 何 才能 证 实数 据 确实 已 经 保存 成 功 了 呢 ? 我 们 可 以 借助 Android 
Device Monitor 工 具 来 查看 一 下 。 点 击 Android Studio 导 航 栏 中 的 

Tools 一 Android， 会 看 到 如 图 6.2 所 示 的 工具 列表 。 


© Sync project with Gradle Files 
唱 , Android Device Monitor 
[1 AVD Manager 
SDK Manager 
V Enable ADB Integration 
© Layout Inspector 
® Theme Editor 
QQ Google App Indexing Test 


图 6.2 ” Android 工具 列表 


点 击 Android Device Monitor 束 可 以 打开 Android Device Monitor 工 具 了 ， 
进入 File Explorer 标 签 页 ， 在 这 里 找 
到 /data/data/com.example.filepersistencetest/files/ 目 录 ， 可 以 看 到 生成 了 一 个 


data 文 件 ， 如 图 6.3 所 示 。 


然后 


( 注 : Android 7.0 系 统 的 模拟 器 可 能 无 法 正常 查看 


File Explorer 中 的 内 容 ， 这 或 许 是 新 版 模拟 右 的 一 个 pbug， 可 能 会 在 未 来 的 版 


0 。 如 采 你 遇 
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解决 。 


| Name 


然 后 点 击 图 6. 4 中 无 


1 


EE com.example.broadcastbestpracti 
EB com.example.broadcasttest 
区 com.example.broadcasttest2 
区 com.example.filepersistencetest 
EE cache 
GG code cache 
4 GC fles 
BB data 
GS instant-run 
BB com.example.fragmentbestpractic 
EE com.example.fragmenttest 
ES com.example.listviewtest 
多 com.example.recyclerviewtest 
BS com.example.uibestpractice 
EE com.example,uicustomviews 
BS com. example, uilayouttest 


图 6.3 生成 的 data 文 件 


图 6.4 导入 导出 按钮 


使 用 记事 本 打开 这 


Size 


-Yl 


边 的 按钮 可 以 将 这 


Date 

2016-04-16 
2016-04-16 
2016-04-16 
2016-04-24 
2016-04-24 
2016-04-24 
2016-04-24 
2016-04-24 
2016-04-24 
2016-04-10 
2016-04-09 
2016-04-01 
2016-04-02 
2016-04-04 
2016-03-28 
2016-03-27 


| 全 Network Stat EE? File Explorer 2 


Time 
09:46 
03:40 
07:51 
11:18 
11:18 
11:18 
11:24 


11:24 -| 


11:18 
08:50 
15:20 
12:26 
11:47 
08:13 
14;14 
12:01 


Permissions Info 


drwxr-x--x 


文 个 文件 导出 到 电脑 上 。 
辐 生 | 


文 个 文件 ， 里 面 的 内 容 如 图 6.5 所 示 。 


@ Emulator Co.. | 口 System Infor...| 


| 


[一 】 


到 了 这 种 情况 ， 创 建 一 个 Android 6.0 系 统 的 模拟 器 即 可 


| 


ML 


文件 (月 ”编辑 (E) 格式 (DO) 音 春 (V) 帮助 (H) 


|Content 


图 6.5 data 文件 中 的 内 容 
这 样 歼 证 实 了 ， 在 EditText 中 输入 的 内 容 确实 已 经 成 功 保存 到 文件 中 了 。 


不 过 只 是 成 功 将 数据 保存 下 来 还 不 够 ， 我 们 还 需要 想 办 法 在 下 次 局 动 程序 
的 时 候 让 这 些 数据 能 够 还 原 到 EditText 中 ， 因 此 接 下 来 我 们 就 要 学 习 一 下 如 
何 从 文件 中 读 取 数据 。 


6.2.2 ”从 文件 中 读 取 数据 


类 似 于 将 数据 存储 到 文件 中 ，context 类 中 还 提供 了 一 个 openFileInput() 
方法 ， 用 于 从 文件 中 读 取 数据 。 这 个 方法 要 比 openFileoutput() 简单 一 
些 ， 它 只 接收 一 个 参数 ， 即 要 读 取 的 文件 名 ， 然 后 系统 会 目 动 

到 /data/data/<package name>/files/ 目 录 下 去 加 载 这 个 文件 ， 并 返回 一 个 
FileInputstream 对 象 ， 得 到 了 这 个 对 象 之 后 再 通过 Java 流 的 方式 就 可 以 将 
数据 读 取出 来 了 。 


以 下 是 一 段 简 单 的 代码 示例 ， 展 示 了 如 何 从 文件 中 读 取 文本 数据 : 


public String load() { 

FileInputStream in = null; 

BufferedReader reader = null,; 

StringBuilder content = new StringBuilder(); 

try { 
in = openFileInput("data"); 
reader = new BufferedReader(new InputSstreamReader (in)); 
String line = "",， 
while ((line = reader . readLine()) != null) { 

content.append(line); 


} 
} catch (IOException e) { 
e.printStackTrace( ); 


} finally { 
if (reader != null) { 


try { 
reader .close(); 
} catch (IOException e) { 
e.printStackTrace(); 
} 


} 
} 


return content.toString(); 


在 这 段 代 码 中 ， 首先 通过 openFileInput () 方法 获取 到 了 一 个 


FileInputstream 对 象 ， 然 后 借助 它 叉 构建 出 了 一 个 InputStreamReader 对 

象 ， 接着 再 使 用 InputSstreamReader 构建 出 一 广 BufferedReader 对 和 象 ， 这 样 
我 们 就 可 以 通过 BufferedReader 进行 一 行 行 地 读 取 ， 把 文件 中 所 有 的 文本 

内 容 全 部 读 取 出 来 ， 并 存放 在 一 个 stringBuilder 对 象 中 ， 最 后 将 读 取 到 的 
内 容 返回 就 可 以 了 。 


了 解 了 从 文件 中 读 取 数据 的 方法 ， 那 么 我 们 就 来 继续 完善 上 一 小 节 中 的 例 
子 ， 使 得 重新 启动 程序 时 EditText 中 能 够 保留 我 们 上 次 输入 的 内 容 。 修 改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private EditText edit; 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
edit = (EditText) findViewById(R.id.edit); 
String inputText = load(); 
if (!TextUtils.isEmpty(inputText)) { 
edit.setText(inputText); 
edit.setSelection(inputText.1length()); 
Toast.makeText(this, "Restoring Succeeded"，Toast .LENGTH_SHORT) .show() 
} 
} 


public String load() { 

FileInputStream in = null; 

BufferedReader reader = null,; 

StringBuilder content = new StringBuilder(); 

try { 
in = openFileInput("data"); 
reader = new BufferedReader(new InputStreamReader(in))， 
String line = ""，; 
while ((line = reader.readLine()) != null) { 

content.append(line); 


} 
} catch (IOException e) { 


e,printStackTrace( ); 
} finally { 
if (reader != null) { 
try { 
reader .close(); 
} catch (IOException e) { 
e.printSstackTrace( ); 
} 
} 


return content.toString(); 


} 


可 以 看 到 ， 这 里 的 思路 非常 简单 ， 在 oncreate( ) 方法 中 调用 1oad() 方法 来 
读 取 文件 中 存储 的 文本 内 容 ， 如 果 读 到 的 内 容 不 为 nul1 ， 就 调用 EditText 的 
setText( ) 方法 将 内 容 填 充 到 EditText 里 ， 并 调用 setselection( ) 方法 将 输 


入 光标 移动 到 文本 的 末尾 位 置 以 便于 继续 输入 ， 然 后 弹出 一 句 还 原 成 功 的 
提示 。1load() 方法 中 的 细节 我 们 在 前 面 已 经 讲 过 ， 这 里 惑 不 再 费 述 了 。 


注意 ， 上 壕 代 码 在 对 字符 串 进行 非 空 判断 的 时 候 使 用 了 
TextuUtils,.isEmpty() 方法 ， 这 是 一 个 非常 好 用 的 方法 ， 它 可 以 一 次 性 进行 
两 种 空 值 的 判断 。 当 传 入 的 字符 串 等 于 nu11 或 者 等 于 空 字 符 串 的 时 候 ， 这 
个 方法 都 会 返回 true ， 从 而 使 得 我 们 不 需要 先 单独 判断 这 两 种 空 值 再 使 用 
逻辑 运算 符 连 接 起 来 了 。 


现在 重新 运行 一 下 程序 ， 刚 才 保 存 的 Content 字 符 串 肯定 会 被 填充 到 EditText 
中 ， 然 后 编写 一 点 其 他 的 内 容 ， 比 如 在 EditText 中 输入 Hello， 接 着 按 下 Back 
键 退 出 程序 ， 再 重新 启动 程序 ， 这 时 刚才 输入 的 内 容 并 不 会 丢失 ， 而 是 还 
原 到 了 EditText 中 ， 如 图 6.6 所 示 。 


FilePersistenceTest 


Restoring Succeeded 


图 6.6 成 功 还 原 保存 的 内 容 


这 样 我 们 就 已 经 把 文件 存储 方面 的 知识 学 习 完 了 ， 其 实 所 用 到 的 核心 技术 
就 是 context 类 中 提供 的 openFileInput() 和 openFileoutput() 方法 ， 之 后 
瓯 是 利用 Java 的 各 种 流 来 进行 读 写 操作 。 


不 过 正如 我 前 面 所 说 ， 文 件 存储 的 方式 并 不 适合 用 于 保存 一 些 较为 复杂 的 
文本 数据 ， 因 此 ， 下 面 我 们 就 来 学 习 一 下 Android 中 另 一 种 数据 持久 化 的 广 
式 ， 它 比 文件 存储 更加 简单 吻 用 ， 而 且 可 以 很 方便 地 对 茶 一 指定 的 数据 浊 
行 读 写 操作 。 


6.3 ”SharedPreferences 存 储 


不 同 于 文件 的 存储 方式 ，SharedPreferences 是 使 用 键 值 对 的 方式 来 存储 数据 
的 。 也 就 是 说 ， 当 保存 一 条 数据 的 时 候 ， 需 要 给 这 条 数据 提供 一 个 对 应 的 
键 ， 这 样 在 读 取 数据 的 时 候 就 可 以 通过 这 个 键 把 相应 的 值 取出 来 。 而 且 


SharedPreferences 还 文 持 多 种 不 同 的 数据 类 型 存储 ， 如 果 存 储 的 数据 类 型 是 
整 型， 那么 读 取 出 来 的 数据 也 是 整 型 的 ， 如 果 存 储 的 数据 是 一 个 字符 串 ， 
那么 读 取 出 来 的 数据 仍然 是 字符 串 。 


这 样 你 应 该 束 能 明显 地 感觉 到 ， 使 用 SharedPreferences 来 进行 数据 持久 化 要 


比 使 用 文件 方便 很 多 ， 下 面 我 们 就 来 看 一 下 它 的 具体 用 法 吧 。 
6.3.1 ”将 数据 存储 到 SharedPreferences 中 


要 想 使 用 SharedPreferences 来 存储 数据 ， 首 先 需 要 获取 到 sharedPreferences 


对 象 。Android 中 主要 提供 了 3 种 方法 用 于 得 到 sharedpreferences 对 象 。 


01. 


DN 


0 


03. 


Context 类 中 的 getsharedPreferences() 方法 


此 方法 接收 两 个 参数 ， 第 一 个 参数 用 于 指定 SharedPreferences 文 件 的 名 

称 ， 如 果 指 定 的 文件 不 存在 则 会 创建 一 个 ，SharedPreferences 文 件 都 是 
存放 在 /data/data/<package name>/shared_prefs/ 目 录 下 的 。 第 二 个 参数 用 
于 指定 操作 模式 ， 目 前 只 有 MODE_PRIVATE 这 一 种 模式 可 选 ， 它 是 默 
认 的 操作 模式 ， 和 直接 传 入 0 效果 是 相同 的 ， 表 示 只 有 当前 的 应 用 程序 
才 可 以 对 这 个 SharedPreferences 文 件 进 行 读 写 。 其 他 几 种 操作 模式 均 已 
被 废 齐 ，MODE _ WORLD _ READABLE 和 

MODE WORLD_WRITEABLE 这 两 种 模式 是 在 Android 4.2 版 本 中 被 废 

弃 的 ，MODE_MULTI_PROCESS 模 式 是 在 Android 6.0 版 本 中 被 废弃 

的 。 


.Activity 类 中 的 getpreferences() 方法 


这 个 方法 和 Context 中 有 的 getSharedPreferences() 方法 很 相似 ， 不 过 它 
只 接收 一 个 操作 模式 参数 ， 因 为 使 用 这 个 方法 时 会 目 动 将 当前 活动 的 
类 名 作为 SharedPreferences 的 文件 名 。 


PreferenceManager 类 中 的 getDefaultsharedPreferences() 方法 


这 是 一 个 静态 方法 ， 它 接收 一 个 context 参数 ， 并 自动 使 用 当前 应 用 程 
序 的 包 名 作为 前 缀 来 命名 SharedPreferences 文 件 。 得 到 了 
SharedPreferences 对 象 之 后 ， 吕 可 以 开始 同 SharedPreferences 文 件 中 存 
储 数据 了 ， 主 要 可 以 分 为 3 步 实现 。 


(1) 调用 sharedPreferences 对 象 的 edit() 方法 来 获取 一 个 


SharedPreferences.Editor 对 和 象 8 


(2) 回 Sharedpreferences.Editor 对 象 中 添加 数据 ， 比 如 添加 一 个 布尔 
型 数据 束 使 用 putBoolean() 方法 ， 添 加 一 个 字符 串 则 使 用 putstring() 
方法 ， 以 此 类 推 。 


(3) 调用 apply() 方法 将 添加 的 数据 提交 ， 从 而 完成 数据 存储 操作 。 
不 知 不 觉 中 已 经 将 理论 知识 介绍 得 挺 多 了 ， 那 我 们 束 赶 快 通过 一 个 例子 来 


Le 下 SharedPreferences 存 储 的 用 法 吧 。 新 建 一 个 SharedPreferencesTest 项 
， 然 后 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:orientation="vertical" > 


<Button 
android:id="@+id/save_data" 
android:layout_width="match_parent" 


android:layout_height="wrap_content" 
android:text="Save data" 
/> 


</LinearLayout> 


这 里 我 们 不 做 任何 复杂 的 功能 ， 只 是 简单 地 放置 了 一 个 按钮 ， 用 于 将 一 些 
数据 存储 到 SharedPreferences 文 件 当 中 。 然 后 修改 MainActivity 中 的 代码 ， 如 
下 所 示 : 


public class MainActivity extends AppCompatActivity { 


Q@Override 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
Button saveData = (Button) findViewById(R.id.save_ data); 
saveData.setonclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
SharedPreferences.Editor editor = getSharedPreferences("data", 
MODE_PRIVATE) .edit()， 
editor.putSstring("name", "Tom"); 
editor.putInt("age", 28); 
editor.putBoolean("married", false); 
editor.apply(); 


}); 


可 以 看 到 ， 这 里 首先 给 按钮 注册 了 一 个 点 击 事件 ， 然 后 在 点 击 事件 中 通过 
getSharedPreferences() 方法 指 并 得 
到 了 sharedPreferences.Editor 对 象 。 接着 问 这 个 对 象 中 添加 了 3 条 不 同类 
型 的 数据 ， 最 后 调用 apply( ) 方法 进行 提交 ， 从 而 完成 了 数据 存储 的 操作 。 


很 简单 吧 ? 现在 就 可 以 运行 一 下 程序 了 ， 进 入 程序 的 主 界面 后 ， 点 击 一 下 
Save data 按 钮 。 这 时 的 数据 应 该 已 经 保存 成 功 了 ， 不 过 为 了 证 实 一 下 ， 我 们 
还 是 要 借助 File Explorer 来 进行 查看 。 打 开 Android Device Monitor， 并 点 击 
File Explorer 标 签 页 ， 然 后 进入 

到 /data/data/com.example.sharedpreferencestest/shared_prefs/ 目 录 下 ， 可 以 看 
到 生成 了 一 个 data.xml 文 件 ， 如 图 6.7 所 示 。 


翁 Threads | 上 Heap | 旧 Allocation Tr. | 令 Network Stat... | 局, File Explorer 3 | 国 Emulator Co... 口 System Infor.. = 日 | 


答 自 | 一 | + 

Name Size Date Time Permissions Info - 
EE com.example.filepersistencetest 2016-04-24 11:18 drwxr-x--x 
EB com.example.fragmentbestpractice 2016-04-10 08:50 drwxr-x--x 
EE com.example,fragmenttest 2016-04-09 15:20 drwxr-x--x 
EB com.example.listviewtest 2016-04-01 12:26 drwxr-x--x 
EG com.example.recyclerviewtest 2016-04-02 11:47 drwxr-x--x 
4 (> com.example.sharedpreferencestest 2016-04-30 11:30 drwxr-x--x 
GCG cache 2016-04-30 11:29 drwxrwx--x 
CG code_cache 2016-04-30 11:29 drwxrwx--x 

GC flles 2016-04-30 11:29 drwx------ 3 

4 GG shared_prefs 2016-04-30 11:30 drwxrwx--x 站 
BB data.xml 186 2016-04-30 11:30 -rw-rw---- 
ES com.example.uibestpractice 2016-04-04 08:13 drwxr-x--x 
双 com.example,uicustomviews 2016-03-28 14:14 drwxr-x--x 
BS com.example.uilayouttest 2016-03-27 12:01 drwxr-x--x 
区 com.example,uisizetest 2016-04-04 05:12 drwxr-x--x 

BG com.google.android.apps.maps 2016-04-30 08:10 drwxr-x--x 


图 6.7 生成 的 data.xml 文 件 


接 下 来 ， 同 样 是 点 击 导 出 按钮 将 这 个 文件 导出 到 电脑 上 ， 并 用 记事 本 进行 
查看 ， 里 面 的 内 容 如 图 6.8 所 示 。 


文件 (站 ”编辑 (E) ”格式 (DO) 前 看 (V) ”帮助 (H) 


《9xml version= 1.0 encodine=’ utf-8” standalone= yes ?> < 
<map> 
《string name=" ‘name “>Tom/string> 
<boolean name= ， “married” value= ‘false” /> 
> 


《int name= age”value= “28” / 
</map> 


图 6.8 data.xml 文 件 中 的 内 容 


可 以 看 到 ， 我 们 刚刚 在 按钮 的 点 击 事件 中 添加 的 所 有 数据 都 已 经 成 功 保存 
下 来 了 ， 并 且 SharedPreferences 文 件 是 使 用 XML 格式 来 对 数据 进行 管理 的 。 


那么 接 下 来 我 们 目 然 要 看 一 看 ， 如 何 从 SharedPreferences 文 件 中 去 读 取 这 些 
数据 了 。 


6.3.2 ”从 SharedPreferences 中 读 取 数据 


你 应 该 已 经 感觉 到 了 ， 使 用 SharedPreferences 来 存储 数据 是 非常 简单 的 ， 不 
过 下 面 还 有 更 好 的 消息 ， 其 实 从 SharedPreferences 文 件 中 读 取 数据 会 更 加 地 
人 简单。sharedPreferences 对 象 中 提供 了 一 系列 的 get 方法 ， 用 于 对 存储 的 

数据 进行 读 取 ， 每 种 get 方法 都 对 应 了 SharedPreferences .Editor 中 的 一 种 
put 方法 ， 比 如 读 取 一 个 布尔 型 数据 天 使 用 getBoolean() 方法 ， 读 取 一 个 字 
符 串 就 使 用 getstring() 方法 。 这 些 get 方法 都 接收 两 个 参数 ， 第 一 个 参数 

是 键 ， 传 入 存储 数据 时 使 用 的 键 就 可 以 得 到 相应 的 值 了 ; 第 二 个 参数 是 默 

0 ， 即 表示 当 传 入 的 键 找 不 到 对 应 的 值 时 会 以 什么 样 的 默认 值 进 行 返 


我 们 还 是 通过 例子 来 实际 体验 一 下 吧 ， 仍 然 是 在 SharedPreferencesTest 项 目 
的 基础 上 继续 开发 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 


android:layout_height="match_parent" 
android:orientation="vertical" > 


<Button 
android:id="@+id/save_data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Save data" 
/> 


<Button 
android:id="@+id/restore data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Restore data" 
/> 


</LinearLayout> 


这 里 增加 了 一 个 还 原 数据 的 按钮 ， 我 们 希望 通过 点 击 这 个 按钮 来 从 
SharedPreferences 文 件 中 读 取 数据 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 


Button restoreData = (Button) findViewById(R.id,.restore_ data); 
restoreData.setonClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
SharedPreferences pref = getSharedpPreferences("data", MODE_PRIVATE); 
String name = pref.getSstring("name", ""); 


int age = pref.getInt("age", 0); 

boolean married = pref.getBoolean("married", false); 
Log.d("MainActivity", "name is " + name); 
Log.d("MainActivity", "age is " + age); 
Log.d("MainActivity", "married is " + married); 


可 以 看 到 ， 我 们 在 还 原 数据 按钮 的 点 击 事件 中 首先 通过 
getSharedPreferences() 方法 得 到 了 sharedpreferences 对 和 象 ， 然后 分 别 调 
用 它 的 getstring() 、getInt() 和 getBoolean() 方法 ， 去 获取 前 面 所 存储 的 
姓名 、 年 龄 和 是 否 已 婚 ， 如 果 没 有 找到 相应 的 值 ， 束 会 使 用 方法 中 传 入 的 
默认 值 来 代替 ， 最 后 通过 Log 将 这 些 值 打印 出 来 。 


现在 重新 运行 一 下 程序 ， 并 点 击 界面 上 的 Restore data 按 钮 ， 然 后 查看 logcat 
中 的 打印 信息 ， 如 图 6.9 所 示 。 


Verbose 图 (Q- ) 


com. example. sharedpreferencestest D/MainActivity: name is Tom 


com. example. sharedpreferencestest D/MainActivity: age is 28 


com. example. sharedpreferencestest D/MainActivity: married is false 


图 6.9 打印 data.xml 中 存储 的 内 容 


所 有 之 前 存储 的 数据 都 成 功 读 取出 来 了 ! 通过 这 个 例子 ， 我 们 就 把 
SharedPreferences 存 储 的 知识 也 学 习 完 了 。 相 比 之 下 ，SharedPreferences 存 储 
确实 要 比 文本 存储 简单 方便 了 许多 ， 应 用 场景 也 多 了 不 少 ， 比 如 很 多 应 用 
程序 中 的 偏好 设置 功能 其 实 都 使 用 到 了 SharedPreferences 技 术 。 那 么 下 面 我 
们 就 来 编写 一 个 记 住 密码 的 功能 ， 相 信和 通过 这 个 例子 能 够 加 深 你 对 
SharedPreferences 的 理解 。 


6.3.3 ”实现 记 住 密码 功能 


既然 是 实现 记 住 密码 的 功能 ， 那 么 我 们 就 不 需要 从 头 去 写 了 ， 因 为 在 上 一 
章 中 的 最 佳 实践 部 分 已 经 编写 过 一 个 登录 界面 了 ， 有 可 以 重用 的 代码 为 什 
么 不 用 呢 ? 那 就 首先 打开 BroadcastBestPractice 项 目 ， 来 编辑 一 下 登录 界面 
的 布局 。 修 改 activity_login.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<LinearLayout 
android:orientation="horizontal" 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 
<CheckBox 
android:id="@+id/remember_pass" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" /> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:textSize="18sp" 
android:text="Remember password" /> 
</LinearLayout> 


<Button 
android:id="@+id/login" 
android:layout_width="match_parent" 
android:layout_height="60dp" 
android:text="Login" /> 
</LinearLayout> 


这 里 使 用 到 了 一 个 新 控件 CheckBox。 这 是 一 个 复 选 框 控件 ， 用 户 可 以 通过 


点 击 的 方式 来 进行 选中 和 取消 ， 我 们 就 使 用 这 个 控件 来 表示 用 户 是 否 需要 
记 住 密码 。 


然后 修改 LoginActivity 中 的 代码 ， 如 下 所 示 : 


public class LoginActivity extends BaseActivity { 


private SharedPreferences pref; 

private SharedPreferences,.Editor editor 
private EditText accountEdit ， 

private EditText passwordEdit; 

private Button login; 

private CheckBox rememberPass; 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setCcontentView(R.1layout.activity_login); 
pref = PreferenceManager .getDefaultSharedPreferences(this); 
accountEdit = (EditText) findViewById(R.id.account); 
passwordEdit = (EditText) findViewById(R.id.password); 
rememberPass = (CheckBox) findViewById(R.id.remember_pass); 
Jogin = (Button) findViewById(R.id.1ogin); 
boolean isRemember = pref.getBoolean("remember_password", false); 
if (isRemember) { 
// 将 账号 和 密码 都 设置 到 文本 框 中 
String account = pref.getString("account", ""); 
String password = pref.getString("password", ""); 
accountEdit.setText(account); 
passwordEdit.setText(password); 
rememberPass.setChecked(true); 


} 


Jogin.setOoncClickListener(new View.OnClickListener() { 
Q@Override 
public void onClick(View v) { 
String account = accountEdit.getText().tostring(); 
String password = passwordEdit.getText().toString(); 
// 如 果 账 号 是 admin 且 密码 是 123456， 就 认为 登录 成 功 
if (account.equals("admin") && password.equals("123456")) { 
editor = pref.edit(); 
if (rememberPass.isChecked()) { // 检查 复 选 框 是 否 被 选中 
editor.putBoolean("remember_password", true); 
editor.putString("account", account); 
editor.putString("password", password); 
} else { 


editor.clear(); 


editor.apply(); 

Intent intent = new Intent(LoginActivity.this, MainActivity. 
class); 

startActivity(intent); 

finish(); 

} else { 

Toast.makeText(LoginActivity.this, "account or password is 
invalid", 
Toast .LENGTH_SHORT).. show( ); 


可 以 看 到 ， 这 里 首先 在 oncreate() 方法 中 获取 到 了 sharedpreferences 对 
象 ， 然 后 调用 它 的 getBoolean( ) 方法 去 获取 remember_password 这 个 键 对 应 
的 值 。 一 开始 当然 不 存在 对 应 的 值 了 ， 所 以 会 使 用 默认 值 false ， 这 样 就 什 


一 


么 都 不 会 发 生 。 接 着 在 登录 成 功 之 后 ， 会 调用 CheckBox 的 ischecked( ) 方法 
来 检查 复 选 框 是 否 被 选中 ， 如 采 被 选中 了 ， 则 表示 用 户 想 要 记 住 密码 ， 这 
时 将 remember_password 设置 为 true ， 然 后 把 account 和 password 对 应 的 值 
都 存 入 到 SharedPreferences 文 件 当中 并 提交 。 如 有 果 没 有 被 选中 ， 束 简单 地 调 
用 一 下 clear() 方法 ， 将 SharedPreferences 文 件 中 的 数据 全 部 清除 掉 。 


当 用 户 选 中 了 记 住 密码 复 选 框 ， 并 成 功 登录 一 次 之 后 ，remember_password 
键 对 应 的 值 就 是 true 了 ， 这 个 时 候 如 果 再 重新 启动 登录 界面 ， 就 会 从 
SharedPreferences 文 件 中 将 保存 的 账号 和 密码 都 读 取 出 来 ， 并 填充 到 文本 输 
入 框 中 ， 然 后 把 记 住 密码 复 选 框 先 中， 这 样 就 完成 记 住 密码 的 功能 了 。 


现在 重新 运行 一 下 程序 ， 可 以 看 到 界面 上 多 出 了 一 个 记 住 密码 复 选 框 ， 如 
图 6.10 所 示 。 


BroadcastBestPractice 


图 6.10 带 记 住 密码 复 选 框 的 登录 界面 


然后 账号 输入 admin， 密 码 输入 123456， 并 选中 记 住 密码 复 选 杠 ， 点 击 登 

录 ， 就 会 跳 转 到 MainActivity。 接 着 在 MainActivity 中 发 出 一 条 强制 下 线 广 
播 ， 会 让 程序 重新 回 到 登录 界面 ， 此 时 你 会 发 现 ， 账 号 密码 都 已 经 自动 填 
充 到 界面 上 了 ， 如 图 6.11 所 示 。 


BroadcastBestPractice 


admin 


图 6.11 实现 记 住 账号 密码 功能 


这 样 我 们 束 使 用 SharedPreferences 技 术 将 记 住 密码 功能 成 功 实现 了 ， 你 是 不 
是 对 SharedPreferences 理 解 得 更 加 深刻 了 呢 ? 


不 过 需要 注意 ， 这 里 实现 的 记 住 密码 功能 仍然 只 是 个 简单 的 示例 ， 并 不 能 
在 实际 的 项 目 中 直接 使 用 。 因 为 将 密码 以 明文 的 形式 存储 在 
SharedPreferences 文 件 中 是 非常 不 安全 的 ， 很 容易 就 会 补 别 人 瓷 取 ， 因 此 在 
正式 的 项 目 里 还 需要 结合 一 定 的 加 密 算法 来 对 密码 进行 保护 才 行 。 


好 了 ， 天 于 SharedPreferences 的 内 容 束 讲 到 这 里 ， 接 下 来 我 们 要 学 习 一 下 本 
章 的 重头 戏 Android 中 的 数据 库 技 术 。 


6.4 SQLite 数 据 库 存储 


在 刚 开 始 接触 Android 的 时 候 ， 我 甚至 都 不 敢 相信 ，Android 系 统 竟 然 是 内 置 
了 数据 库 的 ! 好 吧 ， 是 我 太 孤 陋 豪 闻 了 “。SQLite 是 一 款 轻 量 级 的 关系 型 数 
据 库 ， 它 的 运算 速度 非常 快 ， 占 用 资源 很 少 ， 通 常 只 需要 儿 百 KB 的 内 存 就 
足够 了 ， 因 而 特别 适合 在 移动 设备 上 使 用 。SQLite 不 仅 文 持 标准 的 SQL 语 
法 ， 还 遵循 了 数据 库 的 ACID 事务 ， 所 以 只 要 你 以 前 使 用 过 其 他 的 夭 系 型 数 
据 库 ， 束 可 以 很 快 地 上 手 SQLite。 而 SQLite 义 比 一 般 的 数据 库 要 简单 得 多 ， 
它 甚 至 不 用 设置 用 户 名 和 密码 束 可 以 使 用 。Android 正 古 把 这 个 功能 极为 强 
人 
路 


前 面 我 们 所 学 的 文件 存储 和 SharedPreferences 存 储 毕 竟 只 适用 于 保存 一 些 简 
单 的 数据 和 键 值 对 ， 当 需要 存储 大 量 复杂 的 关系 型 数据 的 时 候 ， 你 就 会 发 
现 以 上 两 种 存储 方式 很 难 应 付 得 了 。 比 如 我 们 手机 的 短信 程序 中 可 能 会 
很 多 个 会 话 ， 每 个 会 话 中 又 包含 了 很 多 条 信息 内 容 ， 并 且 大 部 分 会 话 还 可 
能 各 自 对 应 了 电话 得 中 的 某 个 联系 人 。 很 难 想象 如 何 用 文件 或 者 
SharedPreferences 来 存储 这 些 数据 量 大 、 结 构 性 复杂 的 数据 吧 ? 但 是 使 用 数 
据 库 就 可 以 做 得 到 。 那 么 我 们 就 赶快 来 看 一 看 ，Android 中 的 SQLite 数 据 库 
到 底 是 如 何 使 用 的 。 


6.4.1 创建 数据 库 


Android 为 了 让 我 们 能 够 更 加 方便 地 管理 数据 库 ， 专 门 提供 了 一 个 
SQLiteOpenHelper 帮 助 类 ， 借 助 这 个 类 束 可 以 非常 答 单 地 对 数据 库 进 行 创建 
和 升级 。 既 然 有 好 东西 可 以 直接 使 用 ， 那 我 们 目 然 要 和 演 试 一 下 了 ， 下 面 我 
就 对 SQLiteOpenHelper 的 基本 用 法 进行 介绍 。 


首先 你 要 知道 SQLiteOpenHelper 是 一 个 抽象 类 ， 这 意味 着 如 果 我 们 想 要 使 用 

它 的 话 ， 残 需要 创建 一 个 自己 的 帮助 类 去 继承 它 。SQLiteOpenHelper 中 有 两 

个 抽象 方法 ， 分 别 是 oncreate() 和 onupgrade() ， 我 们 必须 在 自己 的 帮助 类 

2 
人 逻 清 o 


SQLiteOpenHelper 中 还 有 两 个 非常 重要 的 实例 方法 : getReadableDatabase() 
getwritableDatabase() 。 这 两 个 方法 都 可 以 创建 或 打开 一 个 现 有 的 数据 
库 (如 果 数 据 库 已 存在 则 直接 打开 ， 否 则 创建 一 个 新 的 数据 库 ) ， 并 返回 
一 个 可 对 数据 库 进 行 读 写 操作 的 对 象 。 不 同 的 是 ， 当 数据 库 不 可 写 入 的 时 
候 (如 人 磁盘 空间 已 满 ) ，getReadableDatabase( ) 方法 返回 的 对 象 将 以 只 读 
的 方式 去 打开 数据 库 ， 而 getwritableDatabase() 方法 则 将 出 现 异常 。 


SQLiteOpenHelper 中 有 两 个 构造 方法 可 供 重 写 ， 一 般 使 用 参数 少 一 点 的 那个 
构造 方法 即 可 。 这 个 构造 方法 中 接收 4 个 参数 ， 第 一 个 参数 是 Context， 这 个 
没什么 好 说 的 ， 必 须要 有 它 才 能 对 数据 库 进行 操作 。 第 二 个 参数 是 数据 库 
各， 创建 数据 库 时 使 用 的 残 是 这 里 指定 的 名 称 。 第 三 个 参数 允许 我 们 在 查 
询 数 据 的 时 候 返 回 一 个 自 定义 的 Cursor， 一 般 都 是 传 入 null 。 第 四 个 参数 
表示 当前 数据 库 的 版 本 号 ， 可 用 于 对 数据 库 进 行 升 级 操作 。 构 建 出 
SQLiteOpenHelper 的 实例 之 后 ， 再 调用 它 的 getReadableDatabase() 或 
getwritableDatabase() 方法 就 能 够 创建 数据 库 了 ， 数据 库 文 件 会 存放 

在 /data/data/<package name>/databases/ 目 好 下 。 此 时 ， 重 写 的 oncreate() 方 
法 也 会 得 到 执行 ， 所 以 通常 会 在 这 里 去 处 理 一 些 创建 表 的 逻辑 。 


接 下 来 还 是 让 我 们 通过 例子 的 方式 来 更 加 直观 地 体会 SQLiteOpenHelper 的 用 
法 吧 ， 首 先 新 建 一 个 DatabaseTest 项 目 。 


这 里 我 们 和 希望 创建 一 个 名 为 BookStore.db 的 数据 库 ， 然 后 在 这 个 数据 库 中 新 
建 一 张 Book 表 ， 表 中 有 id (主键 ) 、 作 者 、 价 格 、 页 数 和 书 名 等 列 。 创 建 
数据 库 表 当然 还 是 需要 用 建 表 语句 的 ， 这 里 也 是 要 考验 一 下 你 的 SQL 基本 
功 了 ，Book 表 的 建 表 语 句 如 下 所 示 : 


create table Book ( 
id integer primary key autoincrement, 
author text, 
price real, 


pages integer, 
name text) 


只 要 你 对 SQL 方 面 的 知识 稍微 有 一 些 了 解 ， 上 面 的 建 表 语 句 对 你 来 说 应 该 
都 不 难 吧 。SQLite 不 像 其 他 的 数据 库 拥 有 众多 繁杂 的 数据 类 型 ， 它 的 数据 
类 型 很 简单 ，integer 表示 整 型 ，real 表示 浮 点 型 ，text 表示 文本 类 型 ， 
blob 表示 二 进 制 类 型 。 另 外 ， 上 述 建 表 语 名 中 我 们 还 使 用 了 primary key 将 
id 列 设 为 主键 ， 并 用 autoincrement 关键 字 表 示 id 列 是 自 增长 的 。 


然后 需要 在 代码 中 去 执行 这 条 SQL 语句 ， 才 能 完成 创建 表 的 操作 。 新 建 
MyDatabaseHelper 类 继承 目 SQLiteOpenHelper， 代 码 如 下 所 示 : 


public class MyDatabaseHelper extends SQLiteOpenHelper { 


public static final String CREATE_ BOOK = "create table Book (" 
+ "id integer primary key autoincrement, " 
+ "author text, " 
+ "price real, " 
+ "pages integer, " 


+ "name text)”， 
private Context mContext; 


public MyDatabaseHelper(Context context, String name, 
SQLiteDatabase.CursorFactory factory, int version) { 
super(context, name, factory, version); 
mContext = context; 


} 


Q@Override 
public void onCreate(SQLiteDatabase db) { 
db .execSQL(CREATE_BOOK ) ; 
Toast.makeText(mContext, "Create Succeeded"，Toast .LENGTH_SHORT) ,Show( ) ， 


} 


QOverride 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 


} 


可 以 看 到 ， 我 们 把 建 表 语句 定义 成 了 一 个 字符 串 常 量 ， 然 后 在 oncreate() 
方法 中 又 调用 了 SQLiteDatabase 的 execSsQL( ) 方法 去 执行 这 条 建 表 语句 ， 并 
弹出 一 个 Toast 提 示 创 建成 功 ， 这 样 束 可 以 你 证 在 数据 库 创建 完 成 的 同时 还 
能 成 功 创建 Book 表 。 


现在 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
> 


<Button 
android:id="@+id/create_ database" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Create database" 
/> 


</LinearLayout> 


布局 文件 很 简单 ， 就 是 加 入 了 一 个 按钮 ， 用 于 创建 数据 库 。 最 后 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private MyDatabaseHelper dbHelper; 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
Super .onCreate(SavedInstanceState ) 
setcontentView(R.1layout.activity_main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 1); 
Button createDatabase = (Button) findViewById(R.id.create database); 
createDatabase.setonClickListener(new View.OnCclickListener() { 
Q@Override 
public void oncClick(View v) { 
dbHelper .getwritableDatabase( ); 


}); 


这 里 我 们 在 oncreate( ) 方法 中 构建 了 一 个 MyDatabaseHelper 对 象 ， 并 且 通 
过 构造 画 数 的 参数 将 数据 库 名 指定 为 BookStore.db， 版 本 号 指定 为 1， 然 后 


在 Create database 按 钮 的 点 击 事件 里 调用 了 getwritableDatabase() 方法 。 这 
样 当 第 一 次 点 击 Create database 按 钮 和 时， 就 会 检测 到 当前 程序 中 并 没有 
BookStore.db 这 个 数据 库 ， 于 是 会 创建 该 数据 库 并 调用 MyDatabaseHelper 中 
的 oncreate() 方法 ， 这 样 Book 表 也 残 得 到 了 创建 ， 然 后 会 弹出 一 个 Toast 提 
示 创 建成 功 。 再 次 点 击 Create database 按 钮 时 ， 会 发 现 此 时 已 经 存在 
BookStore.db 数 据 库 了 ， 因 此 不 会 再 创建 一 次 。 


现在 就 可 以 运行 一 下 代码 了 ， 在 程序 主 界面 点 击 Create database 按 钮 ， 结 果 
如 图 6.12 所 示 。 


DatabaseTest 


CREATE DATABASE 


图 6.12 创建 数据 库 成 功 
此 时 BookStore.db 数 据 库 和 Book 表 应 该 都 已 经 创建 成 功 了 ， 因 为 


当 你 再 次 点 


击 Create database 按 钮 时 ， 不 会 再 有 Toast 弹 出 。 可 是 又 回 到 了 之 前 的 那个 老 
问题 ， 怎 样 才能 证 实 它们 的 确 创建 成 功 了 ? 如 采 还 是 使 用 File Explorer， 那 


么 最 多 你 只 能 看 到 databases 目 孙 下 出 现 了 一 个 BookStore.db 文 件 ， 


Book 表 是 


无 法 通过 File Explorer 看 到 的 。 因 此 这 次 我 们 准备 换 一 种 查看 方式 ， 使 用 adb 


shell 来 对 数据 库 和 表 的 创建 情况 进行 检查 。 


adb 是 Android SDK 中 上 自 带 的 一 个 调试 工具 ， 使 用 这 个 工具 可 以 让 


[ 接 对 连接 


在 电脑 上 的 手机 或 模拟 器 进行 调试 操作 。 它 存放 在 sdk 的 platform-tools 目 录 
下 ， 如 果 想 要 在 命令 行 中 使 用 这 个 工具 ， 就 需要 先 把 它 的 路 径 配 置 到 环境 


改 量 里” 


如 采 你 使 用 的 是 windows 系 统 ， 可 以 右 击 计算 机 -属性 ~ 高 级 系 


统 设置 - 环 


境 变量 ， 然 后 在 系统 变量 里 找到 Path 并 点 击 编辑 ， 将 platform-tools 目 孙 配 置 


进去 ， 如 图 6.13 所 示 。 


编辑 系统 变 县 


变量 名 吕 ) : Fath 
变量 值 0 : ta\Local\Android\sdk\platform-tools 


于 确 =d 攻取 消 。 | 


系统 变量 (5) 


变量 值 

0s Windows_NHT 

Path C:\Windows\system32:C: Windows;... 
FATHEXT COM :RRR BAL CHMD :Yhe. VDRO 
PRnPFRSSmnR AR ANTIRd 


新 建 m)..，| | 编辑 红 )... 出 除 红 ) 
确定 取消 


- 


图 6.13 Windows 下 配置 环境 变量 


如 果 你 使 用 的 是 Linux 或 Mac 系 统 ， 可 以 在 home 路 径 下 编辑 .bash_ 文 件 ， 将 
platform-tools 目 未 配置 进去 即 可 ， 如 图 6.14 所 示 。 


Terminal 
/android-sdk-linux/platform-tools 


图 6.14 ” Linux 或 Mac 下 配置 环境 变量 


配置 好 了 环境 变量 之 后 ， 就 可 以 使 用 adb 工 具 了 。 打 开 命令 行 界面 ， 输 入 adb 
shell ， 束 会 进入 到 设备 的 控制 台 ， 如 图 6.15 所 示 。 


一 
呵 C\‘Windows\system32\cmd.exe - adb shell 
a 


Microsoft Windows [ 唉 本 6.1.?6811] 区 
版 权 所 有 《cec》 2989 Microsoft Corporation。 保 留 所 有 权利 。 


CsersNIony>adhb shell 


并 


图 6.15 进入 设备 的 控制 台 


其 中 ，# 符 号 是 超级 管理 员 的 意思 ， 也 束 是 说 现在 你 可 以 访问 模拟 器 中 的 
切 数据 。 如 采 你 的 命令 行 上 显示 的 是 $ 符 号 ， 那 么 束 表 示 你 现在 是 普 遇 管理 
员 ， 需 输入 su 命令 切换 成 超级 管理 员 ， 才 能 执行 下 面 的 操作 。 


接 下 来 使 用 cd 命令 进入 到 /data/data/com.example.databasetestVdatabases/ 目 孙 
下 ， 并 使 用 1s 命令 查看 到 该 目录 里 的 文件 ， 如 图 6.16 所 示 。 


CUsersNIony>adhb shell 
cd Adata/data/com.example.databasetest/databases/ 
cd /data/data/com.example.databhasetest/databases/ 


BookStore .db 
BookStore .db—journal 
导 


图 6.16 查看 数据 库 文件 


这 个 目录 下 出 现 了 两 个 数据 库 文 件 ， 一 个 正 是 我 们 创建 的 BookStore.db， 而 
男 一 个 BookStore.db-journal 则 是 为 了 让 数据 库 能 够 支持 事务 而 产生 的 临时 日 
志文 件 ， 通 常情 况 下 这 个 文件 的 大 小 都 是 0 字 节 。 


摊 下 来 我 们 束 要 借助 sqlite 命令 来 打开 数据 库 了 ， 只 需要 键入 sqlite3， 后 面 
加 上 数据 库 名 即 可 ， 如 图 6.17 所 示 。 


C\Windows\system32\cmd.exe - adb shell 


昔 sqlite3 BookStore .db 人 
sqlite3 BookStore -dhb 

SQLite version 3.7.4 

Enter ".help for instructions 


Enter SQL statements terminated with a 3” 


图 6.17 打开 BookStore.db 数 据 座 


这 时 就 已 经 打开 了 BookStore.db 数 据 库 ， 现 在 就 可 以 对 这 个 数据 库 中 的 表 进 
行 管理 了 。 首 先 来 看 一 下 目前 数据 库 中 有 哪些 表 ， 键 入 .table 命令 ， 如 图 
6.18 所 示 。 


= 
C\Windows\system32\cmd.exe - adb shell I 


-table 


android_metadata 


可 以 看 到 ， 此 时 数据 库 中 有 两 张 表 ，android_metadata 表 是 每 个 数据 库 中 
都 会 自动 生成 的 ， 不 用 管 它 ， 而 男 外 一 张 Book 表 束 是 我 们 在 
MyDatabaseHelper 中 创建 的 了 。 这 里 还 可 以 通过 .schema 命令 来 查看 它们 的 
建 表 语句 ， 如 图 6.19 所 示 。 


Fr 
BC\Windows\system32\cmd.exe - adb shell 


sqlite> -Schema 

-Schema 

CREATE TABLE Book id integer primary key autoincrement, author text,. price real 
> pages integer,. name text»; 

CREATE TABLE android_metadata Clocale TEXT»; 

sqlite> 


图 6.19 ”查看 建 表 语句 


由 此 证 明 ，BookStore.db 数 据 库 和 Book 表 确实 已 经 创建 成 功 了 。 之 后 键 
入 .exit 或 ,quit 命令 可 以 退出 数据 库 的 编辑 ， 再 键入 exit 命令 就 可 以 退出 
设备 控制 台 了 。 


6.4.2 ”升级 数据 库 


如 果 你 足够 细心 ， 一 定 会 发 现 MyDatabaseHelper 中 还 有 一 个 空 方法 呢 ! 没 
错 ，onUpgrade( ) 方法 是 用 于 对 数据 库 进 行 升 级 的 ， 它 在 整个 数据 库 的 管理 
工作 当中 起 着 非常 重要 的 作用 ， 可 于 万 不 能 忽视 它 哟 。 


目前 DatabaseTest 项 目 中 已 经 有 一 张 Book 表 用 于 存放 书 的 各 种 详细 数据 ， 如 
果 我 们 想 再 添加 一 张 Category 表 用 于 记录 图 书 的 分 类 ， 该 怎么 做 呢 ? 


比如 Category 表 中 有 id (主键 ) 、 分 类 名 和 分 类 代码 这 几 个 列 ， 那 么 建 表 语 
句 束 可 以 写成 : 


create table Category ( 
id integer primary key autoincrement, 
category_name text, 


category_code integer) 


接 下 来 我 们 将 这 条 建 表 语 句 添 加 到 MyDatabaseHelper 中 ， 代 码 如 下 所 示 : 


public class MyDatabaseHelper extends SQLiteOpenHelper { 


public static final String CREATE_ BOOK = "create table Book (" 
+ "id integer primary key autoincrement, " 

"author text, " 

"price real, " 

"pages integer, 

"name text)"; 


+ 
下 
十 
4 


public static final String CREATE_CATEGORY = "create table Category (" 
+ "id integer primary key autoincrement, " 
+ "category_name text, " 
+ "category_code integer)"; 


private Context mContext; 


public MyDatabaseHelper(Context context, String name, 
SQLiteDatabase.CursorFactory factory, int version) { 
super(context, name, factory, version); 
mContext = context; 


} 


QOverride 

public void onCreate(SQLiteDatabase db) { 
db .execSQL(CREATE_BOOK ) ; 
db .execSQL(CREATE_CATEGORY ) ; 


Toast.makeText(mContext, "Create Succeeded"，Toast .LENGTH_SHORT) .Show( ) ， 


Q@Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 


} 


看 上 去 好 像 都 挺 对 的 吧 ? 现在 我 们 重新 运行 一 下 程序 ， 并 点 击 Create 
database 按 钮 ， 哮 ? 竟然 没有 弹出 创建 成 功 的 提示 。 当 然 ， 你 也 可 以 通过 
adb 工 具 到 数据 库 中 再 去 检查 一 下 ， 这 样 你 会 更 加 地 确认 Category 表 没有 创 
建成 功 ! 


其 实 没 有 创建 成 功 的 原因 不 难 思考 ， 因 为 此 时 BookStore.db 数 据 库 已 经 存在 
了 ， 之 后 不 管 我 们 怎样 点 击 Create database 按 钮 ，MyDatabaseHelper 中 的 
oncreate() 方法 都 不 会 再 次 执行 ， 因 此 新 添加 的 表 也 就 无 法 得 到 创建 了 。 


解决 这 个 问题 的 办 法 也 相当 简单 ， 只 需要 先 将 程序 和 卸载 挤 ， 然 后 重新 运 
行 ， 这 时 BookStore.db 数 据 库 已 经 不 存在 了 ， 如 采 再 点 击 Create database 按 
钮 ，MyDatabaseHelper 中 的 oncreate() 方法 就 会 执行 ， 这 时 Category 表 就 可 
以 创建 成 功 了 。 


不 过 ， 通 过 乞 载 程序 的 方式 来 新 增 一 张 表 坚 无 疑问 是 很 极端 的 做 法 ， 其 实 
我 们 只 需要 巧妙 地 运用 SQLiteOpenHelper 的 升级 功能 就 可 以 很 轻松 地 解决 这 
个 问题 。 修 改 MyDatabaseHelper 中 的 代码 ， 如 下 所 示 : 


public class MyDatabaseHelper extends SQLiteOpenHelper { 


QOverride 

public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
db.execSsQL("drop table if exists Book"); 
db .execSQL("drop table if exists Category"); 
oncreate(db); 


可 以 看 到 ， 我 们 在 onupgrade() 方法 中 执行 了 两 条 DRoP 语句 ， 如 果 发 现 数据 
库 中 已 经 存在 Book 表 或 Category 表 了 ， 号 将 这 两 张 表 删 除 挥 ,然后 再 调用 


onCreate() 方法 重 狐 创建 。 这 里 先 将 已 经 存在 的 表 删 除 挥 ， 因 为 如 果 在 创 
建 表 时 发 现 这 张 表 已 经 存在 了 ， 束 会 直接 报错 。 


接 下 来 的 问题 就 是 如 何 让 onupgrade( ) 方法 能 够 执行 了 ， 还 记得 
SQLiteOpenHelper 的 构造 方法 里 接收 的 第 四 个 参数 吗 ? 它 表 示 当 前 数据 库 的 
版 本 号 ， 之 前 我 们 传 入 的 是 1， 现 在 只 要 传 入 一 个 比 1 大 的 数 ， 就 可 以 让 
onUpgrade( ) 方法 得 到 执行 了 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private MyDatabaseHelper dbHelper; 


Q@Override 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 
Button createDatabase = (Button) findViewById(R.id.create database); 
createDatabase.setOonClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
dbHelper .getwritableDatabase( ); 


这 里 将 数据 库 版 本 号 指定 为 2， 表 示 我 们 对 数据 库 进行 升级 了 。 现 在 重新 运 
行程 序 ， 并 点 击 Create database 按 钮 ， 这 时 就 会 再 次 弹出 创建 成 功 的 提示 。 
为 了 验证 一 下 Category 表 是 不 是 已 经 创建 成 功 了 ， 我 们 在 adb shell 中 打开 
BookStore.db 数 据 库 ， 然 后 键入 .table 命令， 结果 如 图 6.20 所 示 。 


Category android_metadata 


图 6.20 查看 新 增 表 
接着 键入 .schema 命令 得 看 一 下 建 表 语句 ， 结 果 如 图 6.21 所 示 。 


e> .schema 


TABLE Book (Cid integer primary key autoincrement,. author text。 price real 
integer,. name text>; 


”> pages eg 

CREATE TABLE Category 《id integer primary key autoincrement,. category_ name text. 
category_code integer)»; 

ICREATE TABLE android_metadata Clocale TEX*T»; 

Isqlite> 


图 6.21 查看 新 增 建 表 语 句 


由 此 可 以 看 出 ，Category 表 已 经 创建 成 功 了 ， 同 时 也 说 明 我 们 的 升级 功能 的 
确 起 到 了 作用 。 


6.4.3 ”添加 数据 


现在 你 已 经 掌握 了 创建 和 升级 数据 库 的 方法 ， 接 下 来 就 该 学 习 一 下 如 何 对 
表 中 的 数据 进行 操作 了 。 其 实 我 们 可 以 对 数据 进行 的 操作 无 非 有 4 种 ， 即 
CRUD。 其 中 C 代 表 添 加 〈Create) ，R 代 表 查 询 (Retrieve) ，U 代 表 更 新 

(Update) ，D 代 表 删 除 (Delete) 。 每 一 种 操作 又 各 自 对 应 了 一 种 SQL 命 
令 ， 如 果 你 比较 熟悉 SQL 语言 的 话 ， 一 定 会 知道 添加 数据 时 使 用 insert ， 
查询 数据 时 使 用 select ， 更 新 数据 时 使 用 update ， 删 除数 据 时 使 用 delete 
。 但 是 开发 者 的 水 平 总 会 是 参差 不 齐 的， 未 必 每 一 个 人 都 能 非常 熟悉 地 使 
用 SQL 语言 ， 因 此 Android 也 提供 了 一 系列 的 辅助 性 方法 ， 使 得 在 Android 中 
即使 不 去 编写 SQL 语句 ， 也 能 轻松 完成 所 有 的 CRUD 操 作 。 


前 面 我 们 已 经 知道 ， 调用 SQLiteOpenHelper 的 getReadableDatabase( ) 或 
getwritableDatabase() 方法 是 可 以 用 于 创建 和 升级 数据 库 的 ， 不 仅 如 此 ， 
这 两 个 方法 还 都 会 返回 一 个 SQLiteDatabase 对 象 ， 借 助 这 个 对 象 就 可 以 对 
数据 进行 CRUD 操 作 了 。 


那么 下 面 我 们 首先 学 习 一 下 如 何 向 数据 库 的 表 中 添加 数据 吧 。 
SQLiteDatabase 中 提供 了 一 个 insert() 方法 ， 这 个 方法 就 是 专门 用 于 添加 
数据 的 。 它 接收 3 个 参数 ， 第 一 个 参数 是 表 名 ， 我 们 希望 癌 哪 张 表 里 添 加 数 
据 ， 这 里 就 传 入 该 表 的 名 字 。 第 二 个 参数 用 于 在 未 指定 添加 数据 的 情况 下 
给 某 些 可 为 至 的 列 目 动 赋值 NuLL ， 一 般 我 们 用 不 到 这 个 功能 ， 直 接 传 入 
null 即 可 。 第 三 个 参数 是 一 个 contentvalues 对 象 ， 它 提供 了 一 系列 的 
put() 方法 重 载 ， 用 于 癌 contentvalues 中 添加 数据 ， 只 需要 将 表 中 的 每 个 
列 名 以 及 相应 的 待 添加 数据 传 入 即 可 。 


介绍 完了 基本 用 法 ， 接 下 来 还 是 让 我 们 通过 例子 的 方式 来 茶 刁 体验 一 下 如 
何 添加 数据 吧 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 


> 

<Button 
android:id="@+id/add_data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Add data" 
/> 

</LinearLayout> 


可 以 看 到 ， 我 们 在 布局 文件 中 义 新 增 了 一 个 按钮 ， 稍 后 束 会 在 这 个 按钮 的 
扩 击 事件 里 编写 添加 数据 的 逻辑 。 接 看 修改 MainActivity 中 的 代码 ， 如 下 所 
小: 


public class MainActivity extends AppCompatActivity { 
private MyDatabaseHelper dbHelper; 


QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 


Button addData = (Button) findViewById(R.id.add data); 
addData.setonclickListener(new View.OnClickListener() { 
Q@Override 
public void onClick(View v) { 
SQLiteDatabase db = dbHelper .getwritableDatabase(); 
ContentValues values = new ContentValues(); 
// 开始 组 装 第 一 条 数据 
values.put("name", "The Da Vinci Code"); 
values.put("author", "Dan Brown"); 
values.put("pages", 454); 
values.put("price", 16.96); 
db.insert("Book"，null，values); // 插入 第 一 条 数据 
values.clear(); 
// 开始 组 装 第 二 条 数据 
values.put("name", "The Lost Symbol") ， 
values.put("author", "Dan Brown"); 
values.put("pages", 510); 
values.put("price", 19.95); 
db.insert("Book"，null，values); // 插入 


Nl 


第 二 条 数据 


于 )7 


| 


在 添加 数据 按钮 的 点 击 事件 里 面 ， 我 们 先 获 取 到 了 sQLiteDatabase 对 象 ， 
然后 使 用 contentvalues 来 对 要 添加 的 数据 进行 组 疾 。 如 果 你 比较 细心 的 话 
应 该 会 发 现 ， 这 里 只 对 Book 表 里 其 中 四 列 的 数据 进行 了 组 装 ，id 那 一 列 并 
没 给 它 赋值 。 这 是 因为 在 前 面 创建 表 的 时 候 ， 我 们 就 将 id 列 设置 为 自 增 长 
了 ， 它 的 值 会 在 入 库 的 时 候 目 动 生成 ， 所 以 不 需要 手动 给 它 赋值 了 。 接 下 
来 调用 了 insert() 方法 将 数据 添加 到 表 当 中 ， 注 意 这 里 我 们 实际 上 添加 了 
两 条 数据 ， 上 壕 代 码 中 使 用 contentvalues 分 别 组 装 了 两 次 不 同 的 内 容 ， 并 
调用 了 两 次 insert() 方法 。 


好 了 ， 现 在 可 以 重新 运行 一 下 程序 了 ， 界 面 如 图 6.22 所 示 。 


w 员 12:36 


DatabaseTest 


CREATE DATABASE 


ADD DATA 


图 6.22 ”加 入 添加 数据 按钮 


点 击 一 下 Add data 按 钮 ， 此 时 两 条 数据 应 该 都 已 经 添加 成 功 了 ， 不 过 为 了 证 
实 一 下 ， 我 们 还 是 打开 BookStore.db 数 据 库 瞧 一 瞻 。 输 入 SQL 查 询 语句 
select * from Book; ， 结 果 如 图 6.23 所 示 。 


sqlite> select x fron Book; 
select x from Book; 
i1iDan Brown!16.961454!:The Da Vinci Code 


21Dan Brown!19.95 1!51091The Lost Symbol 
sqlite> 


图 6.23 查看 添加 的 数据 


由 此 可 以 看 出 ， 我 们 刚刚 组 淡 的 两 条 数据 都 已 经 准确 无 误 地 添加 a 到 Book 表 
中 


6.4.4 ”更 新 数据 


学 习 完 了 如 何 癌 表 中 添加 数据 ， 接 下 来 我 们 看 看 怎样 才能 修改 表 中 已 有 的 
数据 。sQLiteDatabase 中 也 提供 了 一 个 非常 好 用 的 update( ) 方法 ， 用 于 对 
数据 进行 更 新 ， 这 个 方法 接收 4 个 参数 ， 第 一 个 参数 和 insert() 方法 一 样 ， 
也 是 表 名 ， 在 这 里 指定 去 更 新 哪 张 表 里 的 数据 。 第 二 个 参数 是 

contentValues 对 象 ， 要 把 更 新 数据 在 这 里 组 装 进 去 。 第 三 、 第 四 个 参数 用 
于 约束 更 新 某 一 行 或 某 几 行 中 的 数据 ， 不 指定 的 话 默 认 就 是 更 新 所 有 行 。 


那么 接 下 来 我 们 仍然 是 在 DatabaseTest 项 目的 基础 上 修改 ， 看 一 下 更 新 数据 
的 具体 用 法 。 比 如 说 刚才 添加 到 数据 库 里 的 第 一 本 书 ， 由 于 过 了 畅销 季 ， 
卖 得 不 是 很 火 了 ， 现 在 需要 通过 降低 价格 的 方式 来 吸引 更 多 的 顾客 ， 我 们 
应 该 怎么 操作 呢 ? 首先 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
> 


<Button 
android:id="@+id/update_data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Update data" 
/> 
</LinearLayout> 


| 


布局 文件 中 的 代码 已 经 非常 滑 单 了 ， 束 是 添加 了 一 个 用 于 更 新 数据 的 按 
钮 。 然 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private MyDatabaseHelper dbHelper; 


Q@Override 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 


Button updateData = (Button) findViewById(R.id.update_ data); 
updateData.setoncClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
SQLiteDatabase db = dbHelper .getwritableDatabase(); 
ContentValues values = new ContentValues(); 
values.put("price", 10.99); 
db.update("Book", values, "name = ?", new String[] { "The Da Vinci 
Code™" }); 


这 里 在 更 新 数据 按钮 的 点 击 事件 里 面 构 建 了 一 个 contentvalues 对 象 ， 并 且 
只 给 它 指定 了 一 组 数据 ， 说 明 我 们 只 是 想 把 价格 这 一 列 的 数据 更 新 成 
10.99。 然 后 调用 了 SsQLiteDatabase 的 update() 方法 去 执行 具体 的 更 新 操 
作 ， 可 以 看 到 ， 这 里 使 用 了 第 三 、 第 四 个 参数 来 指定 具体 更 新 哪儿 行 。 第 
三 个 参数 对 应 的 是 SQL 语句 的 where 部 分 ， 表 示 更 新 所 有 name 等 于 ? 的 行 ， 
而 ? 是 一 个 占 位 符 ， 可 以 通过 第 四 个 参数 提供 的 一 个 字符 串 数 组 为 第 三 个 参 
数 中 的 每 个 占 位 符 指定 相应 的 内 容 。 因 此 上 述 代码 想 表达 的 意图 是 将 名 字 
是 The Da Vinci Code 的 这 本 书 的 价格 改 成 10.99。 


现在 重新 运行 一 下 程序 ， 界 面 如 图 6.24 所 示 。 


w 站 12:49 


DatabaseTest 


CREATE DATABASE 


ADD DATA 


UPDATE DATA 


图 6.24 加 入 更 新 数据 按钮 


点击 一 下 Update data 按 钮 后 ， 再 次 输入 查询 语句 查看 表 中 的 数据 情况 ， 结 有 果 
如 图 6.25 所 示 。 


Ey C\Windows\ 


sqlite> select x from Book; 

select x from Book; 

11Dan Brown :10.991:454!:The Da Vinci code 
21Dan Brown !19.95 15101The Lost Symbhol 
lsqlite> 


图 6.25 查看 更 新 后 的 数据 
可 以 看 到 ，The Da Vinci Code 这 本 书 的 价格 已 经 被 成 功 改 为 10.99 了 。 


6.4.5 “删除 数据 


起 么 样 ? 添加 和 更 新 数据 的 功能 都 还 挺 向 单 的 吧 ， 代 码 也 不 多 ， 理 解 起 来 
那么 我 们 要 马不停蹄 地 开始 学 习 下 一 种 操作 了 ， 即 从 表 中 删除 数 
居 。 


删除 数据 对 你 来 说 应 该 就 更 简单 了 ， 因 为 它 所 需要 用 到 的 知识 点 你 全 部 已 
经 学 过 了 。 SQLiteDatabase 中 提供 了 一 11 delete() 方法 ， 专 门 用 于 删除 数 
据 ， 这 个 方法 接收 3 个 参数 ， 第 一 个 参数 仍然 是 表 名 ， 这 个 已 经 没什么 好 说 
的 了 ， 第 二 、 第 三 个 参数 又 是 用 于 约束 删除 某 一 行 或 某 几 行 的 数据 ， 不 指 
定 的话 默 认 就 是 删除 所 有 行 。 


是 不 是 理解 起 来 很 轻松 了 ? 那 我 们 就 继续 动手 实践 吧 ， 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
> 


<Button 


android:id="@+id/delete _ data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Delete data" 
/> 

</LinearLayout> 


仍然 是 在 布局 文件 中 添加 了 一 个 按钮 ， 用 于 删除 数据 。 然 后 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private MyDatabaseHelper dbHelper; 


Q@Override 

protected void onCreate(Bundle SavedInstanceState) { 
Super .onCreate(SavedInstanceState ) 
setcontentView(R.1layout.activity_main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 


Button deleteButton = (Button) findViewById(R.id.delete data); 
deleteButton.setonclickListener(new View.OnClickListener() { 
QOverride 
public void oncClick(View v) { 
SQLiteDatabase db = dbHelper .getwritableDatabase(); 
db.delete("Book", "pages > ?", new String[] { "500" }); 
} 
}); 


”| 
可 以 看 到 ， 我 们 在 删除 按钮 的 点 击 事件 里 指明 去 删除 Book 表 中 的 数据 ， 并 
且 通 过 第 二 、 第 三 个 参数 来 指定 仅 删除 那些 页 数 超过 500 页 的 书 。 当 然 这 个 
需求 很 奇怪 ， 这 里 也 仅仅 是 为 了 做 个 测试 。 你 可 以 先 查 看 一 下 当前 Book 表 
里 的 数据 ， 其 中 The Lost Symbol 这 本 书 的 页 数 超过 了 500 页 ， 也 残 是 说 当 我 
们 点 击 删除 按钮 时 ， 这 条 记录 应 该 会 被 删除 抒 。 


现在 重新 运行 一 下 程序 ， 界 面 如 图 6.26 所 示 。 


DatabaseTest 


CREATE DATABASE 


ADD DATA 


UPDATE DATA 


DELETE DATA 


图 6.26 加 入 删除 数据 按钮 


点 击 一 下 Delete data 按 钮 后 ， 再 次 输入 查询 语句 查看 表 中 的 数据 情况 ， 结 果 
如 图 6.27 所 示 。 


Code 


图 6.27 查看 删除 后 的 数据 
6.4.6 ”查询 数据 


终于 到 了 最 后 一 种 操作 了 ， 掌 握 了 查询 数据 的 方法 之 后 ， 你 就 将 数据 库 的 
CRUD 操 作 全 部 学 完了 。 不 过 于 万 不 要 因此 而 放松 ， 因 为 查询 数据 是 CRUD 
中 最 复杂 的 一 种 操作 。 


我 们 都 知道 SQL 的 全 称 是 Structured Query Language， 翻 译 成 中 文 就 是 结构 
化 查询 语言 。 它 的 大 部 功能 都 体现 在 “ 查 ” 这 个 字 上 的 ， 而 “增删 改 * 只 是 其 中 
的 一 小 部 分 功能 。 由 于 SQL 查 询 涉 及 的 内 容 实 在 是 太 多 了 ， 因 此 在 这 里 我 
不 准备 对 它 展开 来 讲解 ， 而 是 只 会 介绍 Android 上 的 查询 功能 。 如 果 你 对 
SQL 语 言 非常 感 兴趣 ， 可 以 找 一 本 专门 介绍 SQL 的 书 进行 学 习 。 


相信 你 已 经 猜 到 了 ，SQLiteDatabase 中 还 提供 了 一 个 query() 方法 用 于 对 数 
据 进 行 查 询 。 这 个 方法 的 参数 非常 复杂 ， 最 短 的 一 个 方法 重 载 也 需要 传 入 7 
个 参数 。 那 我 们 就 和 完 来 看 一 下 这 7 个 参数 各 自 的 含义 吧 。 第 一 个 参数 不 用 
说 ， 当 然 还 是 表 名 ， 表 示 我 们 希望 从 哪 张 表 中 查询 数据 。 第 二 个 参数 用 于 
指定 去 查询 哪儿 列 ， 如 果 不 指定 则 默认 查询 所 有 列 。 第 三 、 第 四 个 参数 用 
于 约束 查询 某 一 行 或 菜 几 行 的 数据 ， 不 指定 则 默认 查询 所 有 行 的 数据 。 第 
五 个 参数 用 于 指定 需要 去 group by 的 列 ， 不 指定 则 表示 不 对 查询 结果 进行 
group by 操作 。 第 六 个 参数 用 于 对 group by 之 后 的 数据 进行 进一步 的 过 滤 ， 
不 指定 则 表示 不 进行 过 滤 。 第 七 个 参数 用 于 指定 查询 结果 的 排序 方式 ， 不 
指定 则 表示 使 用 默认 的 排序 方式 。 更 多 详细 的 内 容 可 以 参考 下 表 。 其 他 几 
个 query() 方法 的 重 载 其 实 也 大 同 小 异 ， 你 可 以 自己 去 研究 一 下 ， 这 里 就 不 
再 进行 介绍 了 。 
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columns select column1，column2 指定 查询 的 列 名 


selection where column = value 指定 where 的 约束 条 件 


selectionArgs - ehere 中 的 位 符 提供 具 体 的 值 


having column = value 对 group by 后 的 结果 1 


order by column1，column2 虽 定 查 询 结果 的 排序 方式 


虽然 query() 方法 的 参数 非常 多 ， 但 是 不 要 对 它 产 生 是 惧 ， 因 为 我 们 不 必 为 
每 条 查询 语句 都 指定 所 有 的 参数 ， 多 数 情 况 下 只 需要 传 入 少数 几 个 参数 就 
可 以 完成 查询 操作 了 。 调 用 query() 方法 后 会 返回 一 个 cursor 对 象 ， 查 询 到 
的 所 有 数据 都 将 从 这 个 对 象 中 取出 。 


下 面 还 是 让 我 们 通过 例子 的 方式 来 体验 一 下 查询 数据 的 具体 用 法 ， 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
> 


<Button 
android:id="@+id/query_data" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Query data" 
/> 
</LinearLayout> 


| | 


经 没什么 好 说 的 了 ， 添 加 了 一 个 按钮 用 于 查询 数据 。 然 后 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private MyDatabaseHelper dbHelper; 


Q@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 


Button queryButton = (Button) findViewById(R.id.query_data); 
gueryButton.setonCclickListener(new View.OnClickListener() { 
Q@Override 
public void onClick(View v) { 
SQLiteDatabase db = dbHelper .getwritableDatabase(); 
// 查询 Book 表 中 所 有 的 数据 
Cursor cursor = db.query("Book", null, null, null, null, null, null); 
if (cursor.moveToFirst()) { 
do 区 


// 遍历 Cursor 对 象 ， 取 出 数据 并 打印 

String name = cursor.getString(cursor .getColumnIndex 
("name")); 

String author = cursor.getSstring(cursor.getColumnIndex 
("author")); 

int pages = cursor.getIint(cursor.getCcolumnIndex("pages")); 

double price = cursor.getDouble(cursor.getCcolumnIindex 
("price")); 

Log.d("MainActivity", "book name is " + name); 

Log.d("MainActivity", "book author is " + author); 

Log.d("MainActivity", "book pages is " + pages); 

Log.d("MainActivity", "book price is " + price); 

} while (cursor.moveToNext()); 


} 


cursor.close( ); 


}); 


可 以 看 到 ， 我 们 首先 在 查询 按钮 的 点 击 事件 里 面 调用 了 SQLiteDatabase 的 
query() 方法 去 查询 数据 。 这 里 的 query() 方法 非 帅 简单 ， 只 是 使 用 了 第 一 
个 参数 指明 去 查询 Book 表 ， 后 面 的 参数 全 部 为 nul1 。 这 就 表示 希望 查询 这 
张 表 中 的 所 有 数据 ， 虽 然 这 张 表 中 目前 只 剩 下 一 条 数据 了 。 碍 询 完 之 后 驶 
得 到 了 一 广 Cursor 对 象 ， 接着 我 们 调用 它 的 moveToFirst() 方法 将 数据 的 指 
针 移 动 到 第 一 行 的 位 置 ， ee 去 裔 历 查 询 到 的 每 一 
行 数据 。 在 这 个 循环 中 可 以 通过 cursor 的 getcolumnIndex( ) 方法 获取 到 某 


一 列 在 表 中 对 应 的 位 置 索引 ， 然 后 将 这 个 索引 传 入 到 相应 的 取 值 方法 中 ， 

束 可 以 得 到 从 数据 库 中 读 取 到 的 数据 了 。 接 着 我 们 使 用 Log 的 方式 将 取出 的 
数据 打印 出 来 ， 借 此 来 检查 一 下 读 取 工作 有 没有 成 功 完成 。 最 后 别 志 了 调 
用 close( ) 方法 来 天 闭 cursor 。 


好 了 ， 现 在 再 次 重新 运行 程序 ， 界 面 如 图 6.28 所 示 。 


DatabaseTest 


CREATE DATABASE 


ADD DATA 


UPDATE DATA 


DELETE DATA 


QUERY DATA 


图 6.28 ”加 入 查询 数据 按钮 
点 击 一 下 Query data 按 钮 后 ， 查 看 logcat 的 打印 内 容 ， 结 果 如 图 6.29 所 示 。 
Verbose 图 @- 


com. example. databasetest D/MainActivity: book name is The Da Vinci Code 


com. example. databasetest D/MainActivity: book author is Dan Brown 
com. example. databasetest D/MainActivity: book pages is 454 


com. example. databasetest D/MainActivity: book price is 10.99 


图 6.29 打印 查询 到 的 数据 
可 以 看 到 ， 这 里 已 经 将 Book 表 中 唯一 的 一 条 数据 成 功 地 读 取 出 来 了 。 


当然 这 个 例子 只 是 对 查 询 数 据 的 用 法 进行 了 最 向 单 的 示范 ， 在 真正 的 项 目 
中 你 可 能 会 遇 到 比 这 受 复 杂 得 多 的 查询 功能 ， 更 多 高 级 的 用 法 还 需要 你 自 
己 去 慢 慢 摸索 ， 毕 竞 query() 方法 中 还 有 那么 多 的 参数 我 们 都 还 没 用 到 呢 。 


6.4.7 ”使 用 SQL 操作 数据 库 


虽然 Android 已 4 笃 给 我 们 提供 了 很 多 非常 方便 的 API 用 于 操作 数据 库 ， 不 过 

会 有 一 些 人 不 习惯 去 使 用 这 些 辅 助 性 的 方法 ， 而 是 更 加 青睐 于 直接 使 用 
SCI 末 探 让 艇 从 库 。 这 种 人 一 般 都 属于 SQL 大 牛 ， 如 采 你 也 是 其 中 之 一 的 
话 ， 那 么 茶 喜 ，Android 充 分 考虑 到 了 你 们 的 编程 习惯 ， 同 样 提供 了 一 系列 
的 方法 ， 使 得 可 以 直接 通过 SQL 来 操作 数据 库 。 


下 面 我 就 来 简略 演示 一 下 ， 如 何 直接 使 用 SQL 来 完成 前 面 儿 小 节 中 学 过 的 
CRUD 操 作 。 


。 添加 数据 的 方法 如 下 : 


db .execSQL("insert into Book (name, author, pages, price) values(?, ?3, 7, 2) 
new String[] { "The Da Vinci Code", "Dan Brown", "454" "16. 96" }); 
db .execSQL("insert into Book (name, author, pages, a volves re 


new String[] { "The Lost Symbol", "Dan Brown", "510" "19, 95" }); 


。 更 新 数据 的 方法 如 下 : 


db .execSQL("update Book set price = ? where name = ?", new String[] { "10.99", "The 
Da Vinci Code"” }); 


。 删除 数据 的 方法 如 下 : 


db .execSQL("delete from Book where pages > ?", new String[] { "500" }); 


查询 数据 的 方法 如 下 : 


db.rawQuery("select * from Book", null); 
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可 以 看 到 ， 除 了 查询 数据 的 时 候 调用 的 是 SQLiteDatabase 的 rawQuery() 方 
法 ， 其 他 的 操作 都 是 调用 的 execsQL() 方法 。 以 上 演示 的 几 种 方式 ， 执 行 结 
果 会 和 前 面 儿 小 和 中 我 们 学 习 的 CRUD 操 作 的 结果 完全 相同 ， 选 择 使 用 哪 一 
种 方式 就 看 你 个 人 的 喜好 了 。 


6.5 ”使 用 LitePal 操 作 数 据 库 


上 一 节 中 我 们 学 习 了 使 用 SQLiteDatabase 来 操作 SQLite 数 据 库 的 方法 ， 你 觉 
得 好 用 吗 ? 每 个 人 的 回答 可 能 会 不 一 样 。 但 我 相信 ， 等 学 完了 本 节 的 内 容 
之 后 ， 你 将 再 也 不 想 去 页 SQLiteDatabase 了 。 到 压 是 什么 东西 这 么 神奇 ? 新 
建 一 个 LitePalTest 项 目 ， 然 后 开始 我 们 本 市 的 学 习 之 旅 吧 。 


6.5.1 ”LitePal 简 介 


如 今 ，Android 的 学 习 环 境 比 起 我 当年 学 习 的 时 候 已 经 好 太 多 了 。 当 时 国内 
做 Android 的 人 并 不 多 ， 各 种 学 习 资 料 也 比较 欠缺 ， 一 个 项 目 中 几乎 所 有 的 
功能 都 要 完全 靠 目 己 从 头 来 实现 ， 开 发 效率 之 低下 可 想 而 知 。 


而 现在 开源 的 热潮 让 所 有 Android 开 发 者 都 大 大 受益 ，GitHub 上面 有 成 百 上 
于 的 优秀 Android 开 源 项 目 ， 很 多 之 前 我 们 要 写 很 久 才能 实现 的 功能 ， 使 用 
开源 库 可 能 短 短 几 分 钟 就 能 实现 了 。 除 此 之 外 ， 公 司 里 的 代码 非常 强调 稳 
定性 ， 而 我 们 自己 写 出 的 代码 往往 越 复 杂 就 越 容易 出 问题 。 相 反 ， 开 源 项 
目的 代码 都 是 经 过 时 间 验 证 的 ， 通 常 比 我 们 自己 的 代码 要 稳定 得 多 。 
0 很 多 公司 为 了 追求 开发 效率 以 及 项 目 稳定 性 ， 都 会 选择 使 用 开 
源 库 。 


本 书 中 我 们 将 会 学 习 多 个 开源 库 的 使 用 方法 ， 而 现在 你 将 正式 开始 接触 第 
一 个 开源 库 一 一 LitePal 。 


LitePal 是 一 款 开源 的 Android 数 据 库 框 架 ， 它 采用 了 对 象 关系 映射 (ORM) 
的 模式 ， 并 将 我 们 平时 开发 最 党 用 到 的 一 些 数 据 库 功 能 进行 了 封闭， 使 得 
不 用 编写 一 行 SQL 语句 就 可 以 完成 各 种 建 表 和 增删 改 查 的 操作 。LitePal 的 项 
日 主页 上 也 有 详细 的 使 用 文档 ， 地 址 是 : 
https://github.com/LitePalFramework/LitePal 。 


6.5.2 ”配置 LitePal 


那么 怎样 才能 在 项 目 中 使 用 开源 库 呢 ? 过 去 的 方式 比较 复杂 ， 通 常 需 要 下 
载 开源 库 的 Jar 包 或 者 源码 ， 然后 再 集成 到 我 们 的 项 目 当中 。 而 现在 驶 简单 
得 多 了 ， 大 多 数 的 开源 项 目 都 会 将 版 本 提交 到 jcenter 上 ， 我 们 只 需要 在 

i 声明 该 开源 库 的 引用 束 可 以 了 。 


因此 ， 要 使 用 LitePal 的 第 一 步 ， 就 是 编辑 app/build.gradle 文 件 ， 在 
dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android.support:appcompat-v7:23.2.0' 
testCompile 'junit:junit:4.12"' 
compile 'org.litepal.android:core:1.4.1"' 


添加 的 这 一 行 声明 中 ， 前 面部 分 是 固定 的 ， 最 后 的 1.4.1 是 版 本 号 的 意思 ， 
最 新 的 版 本 号 可 以 到 LitePal 的 项 目 主页 上 去 查看 。 


这 样 我 们 就 把 LitePal 成 功 引 入 到 当前 项 目 中 了 ， 接 下 来 需要 配置 litepal.xml 
文件 。 右 击 app/src/main 目 录 一 New 一 Directory， 创 建 一 个 assets 目 隶 ， 然 后 
在 assets 目 孙 下 再 新 建 一 个 litepal.xml 文 件 ， 接 着 编辑 litepal.xzml 文 件 中 的 内 
容 ， 如 下 所 示 : 


<?xml1 version="1.0" encoding="utf-8"?> 
<litepal> 
<dbname value="BookStore" ></dbname> 


<version value="1" ></version> 


<list> 
</list> 
</litepal> 


其 中 ，<dbname> 标签 用 于 指定 数据 库 名 ，<version> 标签 用 于 指定 数据 库 版 
本 号 ，<1list> 标签 用 于 指定 所 有 的 映射 模型 ， 我 们 稍 后 就 会 用 到 。 


最 后 还 需要 再 配置 一 下 LitePalApplication， 修 改 AndroidManifest.xml 中 的 代 
码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 

package="com.example.litepaltest"> 

<application 
android:name="org.litepal.LitePpalApplication" 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 
</manifest> 


这 里 我 们 将 项 目 的 application 配置 为 org .litepal.LitepPalApplication ， 
这 样 才能 让 LitePal 的 所 有 功能 都 可 以 正 第 工作 。 关 于 application 的 作用 ， 
我 们 之 前 并 没有 进行 过 详细 的 讲解 ， 现 在 你 只 需要 知道 必须 这 么 写 就 行 
了 ， 我 们 将 会 在 第 13 章 中 学 习 application 的 更 多 内 容 。 


现在 LitePal 的 配置 工作 已 经 全 部 结束 了 ， 下 面 我 们 开始 正式 使 用 它 吧 。 


6.5.3 ”创建 和 升级 数据 库 


我 们 之 前 创建 数据 库 是 通过 自 定义 一 个 类 继承 自 SQLiteOpenHelper， 然 后 在 
oncreate( ) 方法 中 编写 建 表 语句 来 实现 的 ， 而 使 用 LitePal 束 不 用 再 这 么 麻 
烦 了 。 本 下 中 我 们 会 使 用 LitePal 来 逐一 完成 上 一 蔬 中 所 学 的 所 有 功能 ， 以 
此 来 对 比 它 们 之 间 的 差距 ， 那 么 为 了 方便 测试 ， 我 们 先 将 activity_main.xml 
布局 文件 从 DatabaseTest 项 目 复 制 到 LitePalTest 项 目 中 来 。 


刚才 在 介绍 的 时 候 已 经 说 过 ，LitePal 采 取 的 是 对 象 关 系 映 射 (ORM) 的 模 
式 ， 那 么 什么 是 对 象 关系 映射 呢 ? 简单 点 说 ， 我 们 使 用 的 编程 语言 是 面向 
对 象 语言 ， 而 使 用 的 数据 库 则 是 关系 型 数据 库 ， 那 么 将 面向 对 象 的 语言 和 
面向 关系 的 数据 库 之 间 建 立 一 种 映射 关系 ， 这 就 是 对 象 关系 映射 了 。 


不 过 你 可 干 万 不 要 小 看 对 象 天 系 映 射 模式 ， 它 赋予 了 我 们 一 个 强大 的 功 
能 ， 束 是 可 以 用 面向 对 象 的 思维 来 操作 数据 库 ， 而 不 用 再 和 SQL 语 句 打 交 
道 了 ， 不 信 的 话 我 们 现在 就 来 体验 一 下 。 比 如 在 6.4.1 小 让 中 ， 为 了 创建 一 
张 Book 表 ， 需 要 先 分 析 表 中 应 该 包含 哪些 列 ， 然 后 再 编写 出 一 条 建 表 语 
人 句 ， 最 后 在 自 定义 的 SQLiteOpenHelper 中 去 执行 这 条 建 表 语句 。 但 是 使 用 
LitePal， 你 束 可 以 用 面 同 对 象 的 思维 来 实现 同样 的 功能 了 ， 定 义 一 个 Book 
类 ， 代 码 如 下 所 示 : 


public class Book { 
private int id; 
private String author; 
private double price; 
private int pages; 
private String name; 
public int getId() { 


return id; 
} 


public void setId(int id) { 
this.id = id; 
} 


public String getAuthor() { 
return author ， 
} 


public void setAuthor(String author) { 
this.author = author; 
} 


public double getPrice() { 
return price; 
} 


public void setPrice(double price) { 
this.price = price; 
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public int getPages() { 


return pages; 


} 


public void setPages(int pages) { 
this.pages = pages; 
} 


public String getName() { 
return name; 
} 


public void setName(String name) { 
this.name = name; 
} 


这 是 一 个 典型 的 Java bean， 在 Book 类 中 我 们 定义 了 id 、author 、price 、 
pages 、name 这 几 个 字段 ， 并 生成 了 相应 的 getter 和 setter 方法 。! 相应 你 
己 经 能 猜 到 了 ，Book 类 就 会 对 应 数据 库 中 的 Book 表 ， 而 类 中 的 每 一 个 字段 


分 别 对 应 了 以 了 表 中 的 每 一 个 列 ， 这 束 是 对 象 天 系 映射 最 直观 的 体验 ， 现 在 你 


能 够 理解 得 更 加 请 楚 了 吧 。 
1 生成 getter 和 setter 方法 的 ; 快捷 方式 是 ， 先 将 类 中 的 字段 定义 好 ， 然 后 按 下 Alt + Insert 键 (Mac 
系统 是 command + N) ， 在 弹出 菜单 中 选择 Getter and Setter， 接 着 使 用 Shift 键 将 所 有 字段 都 选中 ， 
最 后 , 点 击 OK 。 


接 下 来 我 们 还 需要 将 Book 类 添加 到 映射 模型 列表 当中 ， 修 改 litepalxml 中 的 
代码 ， 如 下 所 示 : 


<litepal> 
<dbname value="BookStore" ></dbname> 


<version value="1" ></version> 


<list> 
<mapping class="com.example.litepaltest.Book"></mapping> 
</list> 
</litepal> 


这 里 使 用 <mapping> 标签 来 声明 我 们 要 配置 的 映射 模型 类 ， 注 意 一 定 要 使 用 
完整 的 类 名 。 不 管 有 多 少 模型 类 需要 映射 ， 都 使 用 同样 的 方式 配置 在 <1ist> 
标签 下 即 可 。 


没 错 ， 这 样 就 已 经 把 所 有 工作 都 完成 了 ， 现 在 只 要 进行 任意 一 次 数据 库 的 
操作 ，BookStore.db 数 据 库 应 该 束 会 目 动 创建 出 来 。 那 么 我 们 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
Button createDatabase = (Button) findViewById(R.id.create database); 
createDatabase.setonClickListener(new View.OnClickListener() { 
Q@Override 


public void onClick(View v) { 
Litepal.getDatabase( ); 


} 
}); 


其 中 ， 调用 Litepal.getDatabase( ) 方法 瓯 是 一 次 最 简单 的 数据 库 操 作 ， 只 
要 点 击 一 下 按钮 ， a 下 程序 ， 然 后 点 击 
Create database 按 钮 ， 接 着 通过 adb shell 查看 一 下 数据 库 创 建 情 况 ， 如 图 
6.30 所 示 。 


root@generic_x86:/data/data/com.example.litepaltest # cd databases 
root@generic_x86:/data/data/com.example.litepaltest/databases # ls 
BookStoke -dhb 

BookStore .db—journal 


root@Qygeneric_x86:/data/data/com.example.litepaltest/databases # 


图 6.30 查看 数据 库 文件 


非常 棒 ! 数据 库 文 件 已 经 创建 成 功 了 。 接 下 来 我 们 使 用 sqlites 命令 打开 
BookStore.db 文 件 ， 然后 再 使 用 .schema 命令 来 查看 建 表 语句 ， 如 图 6.31 所 
不 。 


sqlite> .Schema 
CREATE TABLE android_metadata Clocale TEXT>; 
CREATE TABLE table_schema Cid integer primary key autoinckement name text。 type 


integer>; 


CREATE TABLE book Cid integer primary key autoincrement.author text,. name text。 
pages integer,. price real)»; 
sqlite> 


图 6.31 查看 建 表 语句 


可 以 看 到 ， 这 里 有 3 张 表 的 建 表 语 句 ， 其 中 android_metadata 表 仍 然 不 用 
管 ，table_schema 表 是 LitePal 内 部 使 用 的 ， 我 们 也 可 以 直接 忽视 ，book 表 
就 是 根据 我 们 定义 的 Book 类 以 及 类 中 的 字段 来 自动 生成 的 了 。 


怎么 样 ， 是 不 是 很 神奇 ? 但 不 用 太 吃惊 ， 因 为 更 加 神奇 的 还 在 后 面 呢 。 
6.4.2 廊 中 我 们 体验 了 使 用 SQLiteOpenHelper 来 升级 数据 库 的 方式 ， 虽 说 功能 
是 实现 了 ,但 你 有 没有 发 现 一 个 问题 ， 就 是 升级 数据 库 的 时 候 我 们 需要 先 
把 之 前 的 表 drop 挥 ， 然 后 再 重新 创建 才 行 。 这 其 实 ee 
因为 这 样 会 造成 数据 丢失 ， 每 当 升 级 一 次 数据 库 ， 之 前 表 中 的 数据 就 全 

下 


当然 如 果 你 是 非常 有 经 验 的 程序 员 ， 也 可 以 通过 复杂 的 逻辑 控制 来 避免 这 
种 情况 ， 但 是 维护 成 本 很 高 。 而 有 了 LitePal， 这 些 就 都 不 再 是 问题 了 ， 使 
用 LitePal 来 升级 数据 库 非 常 非常 简单 ， 你 完全 不 用 思考 任何 的 逻辑 ， 只 需 
要 改 你 想 改 的 任何 内 容 ， 然 后 将 版 本 号 加 1 就 行 了 。 


比如 我 们 想 要 向 Book 表 中 添加 一 个 press (出 版 社 ) 列 ， 直 接 修 改 Book 类 中 
的 代码 ， 添 加 一 个 press 字段 即 可 ， 如 下 所 示 : 


public class Book { 


private String press,; 


public String getPress() { 
return press; 


public void setPress(String press) { 
this.press = press; 


写 此 同时 ， 我 们 还 想 再 洪 加 一 瀛 Category 表 ， 那么 只 需要 新 建 一 个 category 
类 束 可 以 了 ， 代 码 如 下 所 示 : 


public class Category { 
private int id; 
private String categoryName; 
private int categoryCode; 
public void setId(int id) { 


this.id = id; 
} 


public void setCategoryName(String categoryName) { 
this.categoryName = categoryName; 


} 


public void setCategoryCode(int categoryCode) { 
this.categoryCode = categoryCode; 


} 


改 完了 所 有 我 们 想 改 的 东西 ， 只 需要 记得 将 版 本 号 加 1 就 行 了 。 当 然 由 于 这 
里 还 添加 了 一 个 新 的 模型 类 ， 因 此 也 需要 将 它 添加 到 映射 模型 列表 中 。 修 


改 litepal.xml 中 的 代码 ， 如 下 所 示 : 


<litepal> 
<dbname value="BookStore" ></dbname> 


<version value="2" ></version> 


<list> 
<mapping class="com.example.litepaltest.Book"></mapping> 
<mapping class="com.example.litepaltest.Category"></mapping> 
</list> 
</litepal> 


现在 重新 运行 一 下 程序 ， 然 后 点 击 Create database 按 钮 ， 再 查看 一 下 最 新 的 
建 表 语句 ， 结 果 如 图 6.32 所 示 。 


sqlite> -Schema 

CREATE TABLE android_metadata 《1locale TEXT>; 

CREATE TABLE table_schema 《id integer primary key autoincrement.name text,. type 
integer>; 

CREATE TABLE book Cid integer primary key autoincrement.author text, name text。 


pages integer,. price real, press text»; 
ICREATE TABLE category 《id integer primary key autoincrement .categorycode integer 


»- Categoryname text>; 
Isqlite> 


图 6.32 升级 数据 库 后 的 建 表 语句 


可 以 看 到 ，book 表 中 新 增 了 一 个 press 列 ，category 表 也 创建 成 功 了 ， 当 然 
LitePal 还 自动 帮 有 我 们 做 了 一 项 非常 重要 的 工作 ， 允 是 保留 之 前 表 中 的 所 有 
数据 ， 这 样 就 再 也 不 用 担心 数据 丢失 的 问题 了 。 


6.5.4 ”使 用 LitePal 添 加 数据 

体验 了 使 用 LitePal 来 创建 和 升级 数据 库 ， 是 不 是 感觉 已 经 有 一 些小 震撼 了 
呢 ? 不 过 LitePal 所 提供 的 强大 功能 还 远 不 止 于 此 ， 接 下 来 我 们 就 学 习 一 下 
如 何 使 用 它 来 向 数据 库 的 表 中 添加 数据 吧 。 


首先 回顾 一 下 之 前 添加 数据 的 方法 ， 我 们 需要 创建 出 一 个 contentvalues 对 
象 ， 然 后 将 所 有 要 添加 的 数据 put 到 了 这 个 contentvalues 对 象 当中 ， 最 后 再 调 


用 SQLiteDatabase 的 insert() 方法 将 数据 添加 到 数据 库 表 当中 。 


而 使 用 LitePal 来 添加 数据 ， 这 些 操作 可 以 简单 到 让 你 惊叹 ! 我 们 只 需要 创 
建 出 模型 类 的 实例 ， 再 将 所 有 要 存储 的 数据 设置 好 ， 最 后 调用 一 下 save() 
方法 就 可 以 了 。 


下 面 开 始 来 动手 实现 ， 观 察 现 有 的 模型 类 ， 你 会 发 现 它 们 都 是 没有 继 藉 结 
构 的 。 没 错 ， 因 为 LitePal 进 行 表 管理 操作 时 不 需要 模型 类 有 任何 的 继承 结 
构 ， 但 是 进行 CRUD 操 作 时 就 不 行 了 ， 必 须要 继承 上 自 Datasupport 类 才 行 ， 
因此 这 里 我 们 需要 先 把 继承 结构 给 加 上 。 修 改 Book 类 中 的 代码 ， 如 下 所 
人 小: 


public class Book extends DataSupport { 


} 


接 春 我 们 开始 同 Book 表 中 添加 数据 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 
人 小: 


public class MainActivity extends AppCompatActivity { 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
Super .onCreate(SavedInstanceState ) 
setcontentView(R.1layout.activity_main); 


Button addData = (Button) findViewById(R.id.add data); 
addData.setonclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Book book = new Book(); 
book.setName("The Da Vinci Code"); 
book.setAuthor("Dan Brown"); 


book. setPpages(454); 
book.setPrice(16.96); 
book.setPress("Unknow"); 
book. save( ); 


这 上 段 代 码 非 常 神奇 ， 我 们 来 仔细 阅读 一 在 添加 数据 按钮 的 点 击 事件 里 
面 ， 首 先是 创建 出 了 一 个 Book 的 实例 ， 然 后 调用 Book 类 中 的 各 种 set 方法 
对 数据 进行 设置 ， 最 后 再 调用 book. save( ) 方法 就 能 完成 数据 添加 操作 了 。 


那么 这 个 save() 方法 是 从 哪儿 来 的 呢 ? 当然 是 从 Datasupport 类 中 继承 而 来 
的 了 。 除 了 save() 方法 之 外 ，pDatasupport 类 还 给 我 们 提供 了 丰富 的 CRUD 
方法 ， 这 些 我 们 在 后 面 都 会 学 到 。 


现在 重新 运行 程序 ， 点 击 一 下 Add data 按 钮 ， 此 时 数据 应 该 已 经 添加 成 功 
了 ， 我 们 打开 BookStore.db 数 据 库 瞧 一 瞧 。 输 入 SQL 查询 语句 select * from 
Book ， 结 果 如 图 6.33 所 示 。 


ersion 3.8.10.2 2015-05-20 18:17:19 


图 6.33 查看 添加 的 数据 


可 以 看 到 ， 作 者 、 书 名 、 页 数 、 价 格 、 出 版 社 ， 这 些 数据 全 部 精确 无 误 地 
添加 成 功 了 。 


6.5.5 ”使 用 LitePal 更 新 数据 


学 习 完 了 如 何 使 用 LitePal 添 加 数据 ， 搂 下 来 我 们 看 看 怎样 使 用 LitePal 更 新 数 
据 。 更 新 数据 要 比 添加 数据 稍微 复 洒 一 点 ， 因 为 它 的 API 接 口 比 较 多 ， 这 里 
我 们 只 介绍 最 单 用 的 几 种 更 新 方式 。 


目 先 ， 最 人 简单 的 一 种 更 新 方式 束 古 对 已 存储 的 对 象 重 狐 设 值 ， 然 后 重新 调 
用 save() 方法 即 可 。 那 么 这 里 我 们 束 要 了 解 一 个 概念 ， 什 么 是 已 存储 的 对 
象 ? 


对 于 LitePal 来 说 ， 对 象 是 否 已 存储 就 是 根据 调用 model.issaved() 方法 的 结 
果 来 判断 的 ， 返 回 true 束 表 示 已 存储 ， 返 回 false 就 表示 未 存储 。 那 么 接 下 
来 的 问题 就 是 ， 什 么 情况 下 会 返回 true ， 什 么 情况 下 会 返回 false 呢 ? 


实际 上 只 有 在 两 种 情况 下 model .issaved() 方法 才 会 返回 true ， 一 种 情况 是 
已 经 调用 过 model. save() 方法 去 添加 数据 了 ， 此 时 model 会 被 认为 是 已 存储 
的 对 象 。 必 一 种 情况 是 model 对 象 是 通过 LitePal 提 供 的 查询 API 查 出 来 的 ， 
由 于 是 从 数据 库 中 但 到 的 对 象 ， 因 此 也 会 被 认 为 是 已 存储 的 对 象 。 
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由 于 查询 API 我 们 暂时 还 没 学 到 ， 因 此 只 能 先 通过 第 一 种 情况 来 进行 验 订 
修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


Q@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 


Button updateData = (Button) findViewById(R.id.update_ data); 
updateData.setoncClickListener(new View.OncCclickListener() { 
@Override 
public void onClick(View v) { 
Book book = new Book(); 
book.setName("The Lost Symbol"); 
book.setAuthor("Dan Brown"); 
book. setPages(510); 
book.setPrice(19.95); 
book.setPress("Unknow"); 
book. save(); 
book.setPrice(10.99); 
book. save(); 


在 更 新 数据 按钮 的 点 击 事件 里 面 ， 我 们 先是 通过 上 一 小 节 中 学 习 的 知识 汪 
加 了 一 条 Book 数 据 ， 然 后 调用 setprice( ) 方法 将 这 本 书 的 价格 进行 了 修 
改 ， 之 后 再 次 调用 了 save() 方法 。 此 时 Litepal 会 发 现 当前 的 Book 对 象 是 已 
存储 的 ， 因 此 不 会 再 向 数据库 中 去 添加 一 条 新 数据 ， 而 是 会 直接 更 新 当前 


现在 重新 运行 一 下 程序 ， 然 后 点 击 Update data 按 钮 ， 我 们 再 次 输入 查询 语句 
查看 表 中 的 数据 情况 ， 结 末 如 图 6.34 所 示 。 


Enter “help' for usage hints. 
sqlite> select x from Book; 
i1iDan Brown IThe Da Vinci code !454116 .96 1:Unknow 


21Dan Brown!The Lost Sumhbho1l1i510110.99 :Unknow 
sqlite> 


图 6.34 查看 更 新 后 的 数据 


可 以 看 到 ，Book 表 中 新 增 了 一 条 书 的 数据 ， 但 这 本 书 的 价格 并 不 是 一 开始 
设置 的 19.95， 而 是 10.99， 说 明 我 们 的 更 新 操作 确实 生效 了 。 


但 是 这 种 更 新 方式 只 能 对 已 存储 的 对 象 进行 操作 ， 限 制 性 比较 大 ， 接 下 来 
我 们 学 习 为 外 一 种 更 加 灵巧 的 更 新 方式 。 修 改 MainActivity 中 的 代码 ， 如 下 
所 示 : 


public class MainActivity extends AppCompatActivity { 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 


Button updateData = (Button) findViewById(R.id.update_ data); 
updateData.setonCclickListener (new View.OnClickListener() { 
Q@Override 
public void onClick(View v) { 
Book book = new Book(); 


book.setPrice(14.95); 

book.setPress("Anchor"); 

book.updateAll("name = ? and author = ?", "The Lost Symbol", "Dan 
Brown"); 


可 以 看 到 ， 这 里 我 们 首先 new 出 了 一 个 Book 的 实例 ， 然 后 直接 调用 
setpPrice() 和 setPress() 方法 来 设置 要 更 新 的 数据 ， 最 后 再 调用 
updateAll() 方法 去 执行 更 新 操作 。 注意 updateA1l1l() 方法 中 可 以 指定 一 个 
条 件 约 束 ， 和 SQLiteDatabase 中 update( ) 方法 的 where 参数 部 分 有 点 类 似 ， 
但 更 加 简洁 ， 如 果 不 指 定 条 件 语句 的 话 ， 就 表示 更 新 所 有 数据 。 这 里 我 们 
指定 将 所 有 书 名 是 The Lost Symbol 并 且 作 者 是 Dan Brown 的 书 价格 更 新 为 
14.95， 出 版 社 更 新 为 Anchor。 


现在 重新 运行 程序 并 点 击 Update data 按 钮 ， 我 们 再 次 查询 一 下 表 中 的 数据 情 
况 ， 结 果 如 图 6.35 所 示 。 


一 fT ,~ 
Cs 寺内 :LAWVWVInmC 


Enter .help' for usage hints - 


sqlite> select x from Book; 

i1iDan Brown iThe Da Vinci Code 1454116.96 iUnknow 
2iDan Brown IThe Lost Sumhbo1l1i510114.95 :fnchor 
sqlite> 


图 6.35 再次 查看 更 新 后 的 数据 


意料 之 中 ， 第 二 本 书 的 价格 被 更 新 成 了 14.95， 出 版 社 被 更 新 成 了 Anchor。 
怎么 样 ? LitePal 的 更 新 API 是 不 是 明显 比 SQLiteDatabase 的 update() 方法 要 
好 用 多 了 ? 


不 过 ， 在 使 用 updateAl1() 方法 时 ， 还 有 一 个 非常 重要 的 知识 点 是 你 需要 知 
晓 的 ， 就 是 当 你 想 把 一 个 字段 的 值 更 新 成 默认 值 时 ， 是 不 可 以 使 用 上 面 的 
方式 来 set 数据 的 。 我 们 都 知道 ， 在 Java 中 任何 一 种 数据 类 型 的 字段 都 会 有 
默认 值 ， 例 如 int 类 型 的 默认 值 是 0，boolean 类 型 的 默认 值 是 false ， 
string 类 型 的 默认 值 是 nu1l1 。 那 么 当 new 出 一 个 Book 对 象 时 ， 其 实 所 有 字 
段 都 已 经 被 初 识 化 成 默认 值 了 ， 比 如 说 pages 字段 的 值 就 是 0。 因 此 ， 如 果 
我 们 想 把 数据 库 表 中 的 pages 列 更 新 成 0， 直 接 调用 book. setPages(6) 是 不 
可 以 的 ， 因 为 即使 不 调用 这 行 代码 ，pages 字段 本 寻 也 是 0，LitePal 此 时 有 是 
不 会 对 这 个 列 进行 更 狐 的 。 对 于 所 有 想 要 将 为 数据 更 狐 成 默认 值 的 操作 ， 
LitePal 统 一 提供 了 一 个 setTopefault () 方法 ， 然 后 传 入 相应 的 列 名 就 可 以 实 
现 了 。 比 如 我 们 可 以 这 样 写 : 


Book book = new Book(); 
book.setToDefault("pages"); 
book .updateAll( ); 


这 段 代码 的 意思 是 ， 将 所 有 书 的 页 数 都 更 新 为 0， 因 为 updateA11( ) 方法 中 
没有 指定 约束 条 件 ， 因 此 更 新 操作 对 所 有 数据 都 生效 了 。 


6.5.6 ”使 用 LitePal 删 除数 据 


使 用 LitePal 删 除数 据 的 方式 主要 有 两 种 ， 第 一 种 比较 简单 ， 束 是 直接 调用 
已 存储 对 象 的 delete() 方法 殉 可 以 了 ， 对 于 已 存储 对 象 的 概念 ， 我 们 在 上 
一 小 节 中 已 经 学 习 过 了 “。 也 吏 是 说 ， 调 用 过 save() 方法 的 对 象 ， 或 者 是 通 


过 LitePal 提 供 的 查询 API 查 出 来 的 对 象 ， 都 是 可 以 直接 使 用 delete() 方法 来 
删除 数据 的 。 这 种 方式 比较 简单 ， 我 们 就 不 进行 代码 演示 了 ， 下 面 直接 来 
看 另外 一 种 删除 数据 的 方式 。 


修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 


Button deleteButton = (Button) findViewById(R.id.delete data); 
deleteButton.setOonclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
DataSsupport.deleteAll(Book.class, "price < ?", "15"); 


这 里 调用 了 patasupport .deleteAl1() 方法 来 删除 数据 ， 其 中 deleteA11() 方 
法 的 第 一 个 参数 用 于 指定 删除 哪 张 表 中 的 数据 ，Book. alass 就 意 味 着 删除 
Book 表 中 的 数据 ， 后 面 的 参数 用 于 指定 约束 条 件 ， 应 该 不 难 理解 。 那 么 这 
行 代 码 的 意思 就 是 ， 删 除 Book 表 中 价格 低 于 15 的 书 ， 正 好 目前 Book 表 中 有 
两 本 书 ， 一 本 价格 是 16.96， 一 本 价格 是 14.95， 刚 好 可 以 看 出 效果 。 


现在 重新 运行 程序 ， 并 点 击 一 下 Delete data 按 钮 ， 然 后 查询 表 中 的 数据 情 
况 ， 如 图 6.36 所 示 。 


sqlite> select x from Book3 IE 
i1iDan Brown iThe Da Uinci Code 1454116 .96 1Unknow 
sqlite> 


图 6.36 查看 删除 后 的 数据 
可 以 看 到 ， 价 格 低 于 15 的 那 本 书 已 经 被 删除 掉 了 。 


另外 ，deleteAl1() 方法 如 果 不 指定 约束 条 件 ， 就 意味 着 你 要 删除 表 中 的 所 
有 数据 ， 这 一 点 和 updateAl1() 方法 是 比较 相似 的 。 


6.5.7 ”使 用 LitePal 查 询 数 据 


终于 又 到 了 最 复杂 的 得 询 数据 部 分 了 ， 不 过 这 个 “最 复杂 ”只 是 相对 于 过 去 
而 言 ， 因 为 使 用 LitePal 来 查询 数据 一 点 都 不 复 洒 。 我 一 直 都 认为 LitePal 在 查 
询 API 方 面 的 设计 极为 人 性 化 ， 想 想 之 前 我 们 所 使 用 的 query() 方法 ， 元 长 
I 即使 多 数 参 数 都 是 用 不 到 的 ， 也 不 得 不 传 入 
null ， 如 未: 


Cursor cursor = db.query("Book", null, null, null, null, null, null); 


像 这 样 的 代码 仍 怕 十 没 人 会 喜欢 的 。 为 此 LitePal 在 查询 API 方 面 做 了 非常 多 
的 优化 ， 基 本 上 可 以 满足 绝 大 多 数 场景 的 查询 需求 ， 并 且 代 码 十 分 整洁 ， 
下 面 我 们 就 来 一 起 学 习 一 下 。 


首先 分 析 一 下 上 述 代 码 ，query() 方法 中 使 用 了 第 一 个 参数 指明 去 查询 Book 
表 ， 后 面 的 参数 全 部 为 mull1 ， 这 束 表 示 硕 望 查询 这 张 表 中 的 所 有 数据 。 那 
么 使 用 LitePal 如 何 完成 同样 的 功能 呢 ? 非常 简单 ， 只 需要 这 样 写 : 


List<Book> books = DataSupport .findAl1(Book.class ) ， 


怎么 样 ， 代 码 是 不 是 简单 易 懂 多 了 ? 没有 宛 长 的 参数 列表 ， 只 需要 调用 一 
下 findAl1() 方法 ， 然 后 通过 Book .class 参数 指定 查询 Book 表 就 可 以 。 另 

外 ，findA11( ) 方法 的 返回 值 是 一 个 Book 类 型 的 List 集 合 ， 也 就 是 说 ， 我 们 
不 用 像 之 前 那样 再 通过 cursor 对 象 一 行 行 去 取 值 了 ，LitePal 已 经 自动 帮 有 我 
们 完成 了 赋值 操作 。 


下 面 通过 一 个 完整 的 例子 来 实践 一 下 吧 ， 修 改 MainActivity 中 的 代码 ， 如 下 
所 示 : 


public class MainActivity extends AppCompatActivity { 


QOverride 
protected void onCreate(Bundle savedIinstanceState) { 
super.onCreate(savedInstanceState); 


SetContentView(R. Jayout.activity_main) ， 


Button queryButton = (Button) findViewById(R.id.query_data); 
dueryButton,setonCclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
List<Book> books = DataSupport.findAll(Book.class); 
for (Book book: books) { 
Log.d("MainActivity", "book name is " + book.getName()); 
Log.d("MainActivity", "book author is " + book.getAuthor()); 
Log.d("MainActivity", "book pages is " + book.getPpages()); 
Log.d("MainActivity", "book price is " + book.getPrice()); 
Log.d("MainActivity", "book press is " + book.getPpress()); 


查询 的 那 段 代码 刚刚 已 经 解释 过 了 ， 接 下 来 束 是 授 历 List 集 合 中 的 Book 对 


象 ， 并 将 其 中 的 信息 全 部 打印 出 来 。 现 在 重新 运行 一 下 程序 ， 点 击 Query 
data 按 钮 ， 然 后 查看 logcat 的 打印 内 容 ， 结 果 如 图 6.37 所 示 。 


Verbose 图 [IQr 


com. example. litepaltest D/MainActivity: book name is The Da Vinci Code 


com. example. litepaltest D/MainActivity: book author is Dan Brown 
com. example. litepaltest D/MainActivity: book pages is 454 
com. example. litepaltest D/MainActivity: book price is 16.96 


com. example. litepaltest D/MainActivity: book press is Unknow 


图 6.37 打印 查询 到 的 数据 


Book 表 中 只 剩 下 一 条 数据 ， 由 此 可 见 ， 我 们 已 经 将 这 条 数据 成 功 查 询 出 来 
了 。 


除了 findAl1() 方法 之 外 ，LitePal 还 提供 了 很 多 其 他 非常 有 用 的 查询 API 。 
比如 我 们 想 要 查询 Book 表 中 的 第 一 条 数据 就 可 以 这 样 写 : 


Book firstBook = DataSupport.findFirst(Book.class); 


查询 Book 表 中 的 最 后 一 条 数据 束 可 以 这 样 写 


Book lastBook = DataSupport.findLast(Book.class); 


我 们 还 可 以 通过 连 缀 查询 来 定制 更 多 的 查询 功能 


。 select() 方法 用 于 指定 查询 哪儿 列 的 数据 ， 对 应 了 SQL 当中 的 select 
关键 字 。 比 如 只 查 name 和 author 这 两 列 的 数据 ， 就 可 以 这 样 写 : 


List<Book> books = DataSupport.select("name", "author").find(Book.c]lass); 


。 方法 用 于 指定 查询 的 约束 条 件 ， 对 应 了 SQL 当 中 的 where 关键 
。 比 如 只 查 页 数 大 于 400 的 数据 ， 就 可 以 这 样 写 : 


List<Book> books = DataSupport ,where("pages > ?", "400") .find(Book.class) 


。order() 方法 用 于 指定 结果 的 排序 方式 ， 对 应 了 SQL 当中 的 order by 天 
键 字 。 比 如 将 查询 结果 按照 书 价 从 高 到 低 排 序 ， 丈 可 以 这 样 写 : 


List<Book> books = DataSupport.order("price desc").find(Book.class ) ， 


其 中 desc 表示 降序 排列 ，asc 或 者 不 写 表示 升序 排列 。 


。 limit() 方法 用 于 指定 查询 结果 的 数量 ， 比 如 只 查 表 中 的 前 3 条 数据 ， 
束 可 以 这 样 写 : 


List<Book> books = DataSupport.1imit(3).find(Book.class); 


。 offset() 方法 用 于 指定 查询 结 末 的 偏 移 量 ， 比 如 查询 表 中 的 第 2 条 、 第 
3 条 、 第 4 条 数据 ， 束 可 以 这 样 写 : 


List<Book> books = DataSupport.1imit(3).offset(1).find(Book.class); 


由 于 limit(3) 查询 到 的 是 前 3 条 数据 ， 这 里 我 们 再 加 上 offset(1) 进行 一 个 
位 置 的 偏 移 ， 束 能 实现 查询 第 2 条 、 第 3 条 、 第 4 条 数据 的 功能 了 。1imit() 
和 offset() 方法 共同 对 应 了 SQL 当 中 的 limit 关键 字 。 


当然 ， 你 还 可 以 对 这 5 个 方法 进行 任意 的 连 绥 组 合 ， 来 完成 一 个 比较 复杂 的 
查询 操作 : 


List<Book> books = DataSupport.select("name", "author", "pages") 
LL 


.where("pages > ?", "400") 
.order ("pages") 

.1imit(10) 

.offset(10) 
.find(Book.class); 


这 上段 代码 就 表示 ， 查 询 Book 表 中 第 11~20 条 满足 页 数 大 于 400 这 个 条 件 的 
name 、author 和 pages 这 3 列 数 据 ， 并 将 查询 结果 按照 页 数 升序 排列 。 


怎么 样 ? 是 不 是 感觉 LitePal 的 查询 功能 非常 强大 ， 并 且 代码 明显 更 加 简 
清 ? 我 们 需要 用 到 一 个 方法 的 时 候 直 接连 弘一 下 就 可 以 了 ， 不 需要 的 话 就 
可 以 不 写 ， 而 不 是 像 之 前 的 query() 方法 ， 不 管 需 不 需要 用 到 ， 都 必须 要 传 
固定 的 参数 进去 才 行 。 


关于 LitePal 的 查询 API 差 不 多 就 介绍 到 这 里 ， 这 些 API 已 经 足够 我 们 应 对 绝 
大 多 数 场景 的 查询 需求 了 。 当 前 ， 如 果 你 实在 有 一 些 特殊 需求 ， 上 述 的 API 
都 满足 不 了 你 的 时 候 ，LitePal 仍 然 支 持 使 用 原生 的 SQL 来 进行 查询 : 


Cursor c = DataSupport .findBySQL("Sselect * from Book where pages > ? and price < ?3"， 
"400", "20"); 


调用 DataSupport ,findBySQL() 方法 来 进行 原生 查询 ， 其 中 第 一 个 参数 用 于 
指定 SQL 语 句 ， 后 面 的 参数 用 于 指定 占 位 符 的 值 。 注 意 findBysQL() 方法 返 
回 的 是 一 个 cursor 对 象 ， 接 下 来 你 还 需要 通过 之 前 所 学 的 老 方式 将 数据 一 
一 取出 才 行 。 


6.6 ”小结 与 点 评 


过 了 这 一 章 漫 长 的 学 习 ， 我 们 终于 可 以 缓解 一 下 疲劳 ， 对 本 章 所 学 的 知 
结 了 。 本 章 主要 是 对 Android 常 用 的 数据 持久 化 方式 进行 了 
详细 的 讲解 ， 包括 文件 存储 、SharedPreferences 存 储 以 及 数据 库存 储 。 其 中 
文件 适用 于 存储 一 些 人 简单 的 文本 数据 或 者 二 进 制 数据 ，SharedPreferences 适 
用 于 存储 一 些 键 值 对 ， 而 数据 库 则 适用 于 存储 那些 复杂 的 关系 型 数据 。 虽 
然 目前 你 已 经 掌握 了 这 3 种 数据 持久 化 方式 的 用 法 ， 但 是 能 够 根据 项 目的 实 
际 需 求 来 选择 最 合适 的 方式 也 是 你 未 来 需要 继续 探索 的 。 


那么 正如 上 一 章 小 结 里 提 到 的 ， 既 然 现 在 我 们 已 经 掌握 了 Android 中 的 数据 
持久 化 技术 ， 接 下 来 天 应 该 继续 学 习 Android 中 剩余 的 四 大 组 件 了 。 放松 一 
下 目 己 ， 然 后 一 起 踏 上 内 容 提供 器 的 学 习 之 旅 吧 。 


第 7 章 ” 跨 程 序 共 享 数据 一 一 探 守 内 
容 提 供 屁 


在 上 一 章 中 我 们 学 了 Android 数 据 持 久 化 的 技术 ， 包 括 文件 存储 、 
SharedPreferences 存 储 以 及 数据 库存 储 。 不 知道 你 有 没有 发 现 ， 使 用 这 些 持 
入 化 技术 所 保存 的 数据 都 只 能 在 当前 应 用 程序 中 访问 。 虽 然 文件 和 
SharedPreferences 存 储 中 提供 了 MODE _ WORLD _READABLE 和 

MODE WORLD_WRITEABLE 这 两 种 操作 模式 ， 用 于 供给 其 他 的 应 用 程序 
访问 当前 应 用 的 数据 ， 但 这 两 种 模式 在 Android 4.2 版 本 中 都 已 被 废弃 了 。 为 
什么 呢 ? 因为 Android 官 方 已 经 不 再 推荐 使 用 这 种 方式 来 实现 跨 程 序数 据 共 
享 的 功能 ， 而 是 应 该 使 用 更 加 安全 可 靠 的 内 容 提 供 器 技术 。 


可 能 你 会 有 些 疑 玛 ， 为 什么 要 将 我 们 程序 中 的 数据 去 至 给 其 他 程序 呢 7 当 
然 ， 这 个 是 要 视 情 况 而 定 的 ， 比 如 说 账号 和 密码 这 样 的 隐私 数据 显然 古 不 
能 共享 给 其 他 程序 的 ， 不 过 一 些 可 以 让 其 他 程序 进行 二 次 开发 的 基础 性 数 
据 ， 我 们 还 是 可 以 选择 将 其 共享 的 。 例 如 系统 的 电话 筹 程序 ， 它 的 数据 库 
中 保存 了 很 多 的 联系 人 信息 ， 如 琳 这 些 数 据 部 不 允许 第 三 方 的 程序 进行 访 
问 的 话 ， 何 怕 很 多 应 用 的 功能 都 要 大 打折 扣 了 。 除了 电话 短 之 外 ， 还 有 得 
信 、 媒 体 库 等 程序 都 实现 了 跨 程 序数 据 共 圣 的 功能 ， 而 侠 用 的 技术 当然 就 
苹 内 容 提 供 器 了 ， 下 面 我 们 整 来 对 这 一 技术 进行 深入 的 探讨 。 


7.1 内 容 提 供 器 简介 


内 容 提 供 器 (Content Provider) 主要 用 于 在 不 同 的 应 用 程序 之 间 实 现 数 据 共 
享 的 功能 ， 它 提供 了 一 套 完整 的 机 制 ， 人 允许 一 个 程序 访问 男 一 个 程序 中 的 
数据 ， 同 时 还 能 保证 被 访 数据 的 安全 性 。 目 前 ， 使 用 内 容 提 供 絮 是 Android 
实现 跨 程 序 共 侍 数据 的 标准 方式 。 


不 同 于 文件 存储 和 SharedPreferences 存 储 中 的 两 种 全 局 可 读 写 操作 模式 ， 内 
容 提 供 器 可 以 选择 只 对 哪 一 部 分 数据 进行 共享 ， 从 而 保证 我 们 程序 中 的 隐 
私 数据 不 会 有 泄漏 的 风险 。 


不 过 在 正式 开始 学 习 内 容 提供 器 之 前 ， 我 们 需要 先 掌握 男 外 一 个 非常 重要 
的 知识 一 一 Android 运 行 时 权限 ， 因 为 竺 会 的 内 容 提供 禹 示例 中 会 使 用 到 运 
行 时 权限 的 功能 。 当 然 不 光 是 内 容 提 供 器 ， 以 后 我 们 的 开发 过 程 中 也 会 经 
党 使 用 到 运行 时 权限 ， 因 此 你 必须 能 够 牢 牢 掌握 它 才 行 。 


7.2 ”运行 时 权限 


Android 的 权限 机 制 并 不 是 什么 新 鲜 事物 ， 从 系统 的 第 一 个 版 本 开始 束 已 经 
存在 了 。 但 其 实 之 前 Android 的 权限 机 制 在 保护 用 户 安全 和 隐私 等 方面 起 到 
的 作用 比较 有 限 ， 尤 其 是 一 些 大 家 都 离 不 开 的 常用 软件 ， 非 常 容易 “ 店 大 其 
客 ”。 为 此 ，Android 开 发 团队 在 Android 6.0 系 统 中 引用 了 运行 时 权限 这 个 功 
能 ， 从 而 更 好 地 保护 了 用 户 的 安全 和 隐私 ， 那 么 本 万 我 们 就 来 详细 学 习 一 

下 这 个 6.0 系 统 中 引入 的 新 特性 。 


7.2.1 _ Android 权限 机 制 详 解 


首先 来 回顾 一 下 过 去 Android 的 权限 机 制 是 什么 样 的 。 我 们 在 第 5 章 写 
BroadcastTest 项 目的 时 候 第 一 次 接触 了 Android 权 限 相 关 的 内 容 ， 当 时 为 了 
要 访问 系统 的 网 络 状态 以 及 监听 开机 广播 ， 于 是 在 AndroidManifest.xml 文 件 
中 添加 了 这 样 两 句 权 限 声 明 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<uses-permission android:name="android.permission.ACCESS_ NETWORK_STATE" /> 
<uses-permission android:name="android.permission.RECEIVE_ BOOT_COMPLETED" /> 


</manifest> 


| | 


因为 访问 系统 的 网 络 状态 以 及 监听 开机 广播 涉及 了 用 户 设备 的 安全 性 ， 
此 必须 在 AndroidManifest.xml 中 加 入 权限 声明 ， 否 则 我 们 的 程序 就 会 表演 。 


那么 现在 问题 来 了 ， 加 入 了 这 两 句 权限 声明 后 ， 对 于 用 户 来 说 到 底 有 什么 
影响 呢 ? 为 什么 这 样 就 可 以 保护 用 户 设 备 的 安全 性 了 呢 ? 


其 实用 户主 要 在 以 下 两 个 方面 得 到 了 保护 ， 一 方面 ， 如 果 用 户 在 低 于 6.0 系 
统 的 设备 上 安装 该 程序 ， 会 在 安装 界面 给 出 如 图 7.1 所 示 的 提醒 。 这 样 用 户 
ee 从 而 决定 是 否 要 安装 这 个 
程序 。 


7 
人 BroadcastTest 


= 
x 


要 安装 此 应 用 吗 ? 它 将 获得 以 下 权限 : 


设备 相关 权限 
1 查看 网 络 连接 


回 ”开机 启动 


取消 安装 


图 7.1 安装 界面 的 权限 提醒 


男 一 方面 ， 用 户 可 以 随时 在 应 用 程序 管理 界面 查看 任意 一 个 程序 的 权限 申 
请 情况 ， 如 图 7.2 所 示 。 这 样 该 程序 申请 的 所 有 权限 就 尽 收 眼底 ， 什 么 都 瞒 
不 过 用 户 的 眼睛 ， 以 此 保证 应 用 程序 不 会 出 现 各 种 滥用 权限 的 情况 。 


Pk 


默认 操作 


图 7.2 管理 界面 的 权限 展示 


这 种 权限 机 制 的 设计 思路 其 实 非常 位 单 ， 束 古 用 户 如 末 认 可 你 所 申请 的 权 
限 ， 那 么 就 会 安装 你 的 程序 ， 如 果 不 认 可 你 所 申请 的 权限 ， 那 么 拒绝 安装 
就 可 以 了 。 

但 是 理想 是 美好 的 ， 现 实 却 很 残酷 ， 因 为 很 多 我 们 所 离 不 开 的 常用 软件 普 
这 存在 着 滥用 权限 的 情况 ， 不 管 到 压 用 不 用 得 到 ， 反 正 先 把 权限 申请 了 再 


说 。 比 如 说 微 信 所 申请 的 权限 列表 如 图 7.3 所 示 。 


《 ”应 用 信息 


"二 三 | 
分 大 致 位 置 (基于 网 络 ) 


楼 确 位 置 (基于 GPS 和 网 络 


Se ` 击 D1 
ow |! 


图 7.3 微 信 的 权限 列表 


这 只 是 微 信 所 申请 的 一 半 左 右 的 权限 ， 因 为 权限 太 多 一 屏 截 不 下 来 。 其 中 
有 一 些 权 限 我 并 不 认可 ， 比 如 微 信 为 什么 要 读 取 我 手机 的 短信 和 彩信 ? 但 
证 我 个 认可 又 能 怎样 ， 难 违 我 拒绝 安 妾 短信 ? 没 漠 ， 这 种 例子 比比 各 是 ， 

当 一 些 软 件 已 经 让 我 们 产生 依赖 的 时 候 束 会 容易 “ 店 大 欺 客 *"， 反 正 这 个 权 
限 我 束 是 要 了 ， 你 目 己 看 着 办 吧 ! 


Android 开 发 团队 当然 也 意识 到 了 这 个 问题 ,于 是 在 6.0 系 统 中 加 入 了 运行 时 
权限 功能 。 也 就 是 说 ， 用 户 不 需要 在 安装 软件 的 时 候 一 次 性 授权 所 有 申请 
的 权限 ， 而 是 可 以 在 软件 的 使 用 过 程 中 再 对 某 一 项 权限 申请 进行 授权 。 比 


如 说 一 款 相机 应 用 在 运行 时 申请 了 地 理 位 置 定 位 权限 ， 就 算 我 拒绝 了 这 个 
权限 ， 但 是 我 应 该 仍然 可 以 使 用 这 个 应 用 的 其 他 功能 ， 而 不 是 像 之 前 那样 
直接 无 法 安装 它 。 


当然 ， 并 不 是 所 有 权限 都 需要 在 运行 时 申请 ， 对 于 用 户 来 说 ， 不 停 地 授权 
也 很 烦琐 。Android 现 在 将 所 有 的 权限 归 成 了 两 类 ， 一 类 是 普通 权限 ， 一 类 
是 危险 权限 。 谁 确 地 讲 ， 其 实 还 有 第 三 类 特殊 权限 ， 不 过 这 种 权限 使 用 得 
很 少 ， 因 此 不 在 本 书 的 讨论 范围 之 内 。 普 通 权 限 指 的 是 那些 不 会 直接 威胁 
到 用 户 的 安全 和 隐私 的 权限 ， 对 于 这 部 分 权限 申请 ， 系 统 会 目 动 帮 有 我 们 进 
行 授 权 ， 而 不 需要 用 户 再 去 手动 操作 了 ， 比 如 在 BroadcastTest 项 目 中 申请 的 
两 个 权限 天 是 普通 权限 。 和 危险 权限 则 表示 那些 可 能 会 触及 用 户 隐 私 或 者 对 
设备 安全 性 造成 影响 的 权限 ， 如 获取 设备 联系 人 信息 、 定 位 设备 的 地 理 位 
置 等 ， 对 于 这 部 分 权限 申请 ， 必 须要 由 用 户 手 动 点 击 授权 才 可 以 ， 否 则 程 
序 束 无 法 使 用 相应 的 功能 。 

但 是 Android 中 有 一 共有 上 百 种 权限 ， 我 们 怎么 从 中 区 分 哪些 是 普通 权限 ， 
哪些 是 危险 权限 呢 ? 其 实 并 没有 那么 难 ， 因 为 危险 权限 总 共 束 那么 几 个 ， 


除了 和 危险 权限 之 外 ， 剩 余 的 束 都 是 普通 权限 了 。 下 表 列 出 了 Android 中 所 有 
的 危险 权限 ， 一 共生 9 组 24 个 权限 。 


ai 0 
i 
WRITE_CALENDAR 


READ_CONTACTS 


PONIAETS WRITE_CONTACTS 


GET_ACCOUNTS 


LOCATION ACCESS_FINE_LOCATION 
ACCESS_COARSE_LOCATION 


MICROPHONE RECORD_AUDIO 


READ_PHONE_STATE 
CALL_PHONE 
READ_CALL_LOG 
WRITE_CALL_LOG 
ADD_VOICEMAIL 


USE_ SIP 
PROCESS_OUTGOING_CALLS 


BODY_SENSORS 


SEND_SMS 


RECEIVE_SMS 
READ_SMS 


RECEIVE_WAP_PUSH 
RECEIVE_MMS 


STORAGE READ_EXTERNAL_STORAGE 
WRITE_EXTERNAL_STORAGE 


这 张 表 格 你 看 起 来 可 能 并 不 会 那么 轻松 ， 因 为 里 面 的 权限 全 都 是 你 没 使 用 
过 的 。 不 过 没有 关系 ， 你 并 不 需要 了 解 表格 中 每 个 权限 的 作用 ， 只 要 把 它 
当成 一 个 参照 表 来 查看 束 行 了 。 每 当 要 使 用 一 个 权限 时 ， 可 以 先 到 这 张 表 
中 来 查 一 下 ， 如 果 是 属于 这 张 表 中 的 权限 ， 那 么 就 需要 进行 运行 时 权限 处 
理 ， 如 果 不 在 这 张 表 中 ， 那 么 只 需要 在 AndroidManifest.xml 文 件 中 添加 一 下 


权限 声明 殉 可 以 了 。 


另外 注意 


下 ， 表 格 中 每 个 危险 权限 都 属于 一 个 权限 组 ， 我 们 在 进行 运行 


时 权限 处 理 时 使 用 的 是 权限 名 ， 但 是 用 户 一 旦 同意 授权 了 ， 那 么 该 权限 所 
对 应 的 权限 组 中 所 有 的 其 他 权限 也 会 同时 被 授权 。 


访问 


http://developer.android.google.cn/reference/android/Manifest.permission.html 可 


以 查看 Android 系 统 中 完整 的 权限 列表 。 


好 了 ， 关 于 Android 权 限 机 制 的 内 容 束 讲 这 么 多 ， 理 论 知 识 你 已 经 了 解 得 非 
常 充足 了 。 接 下 来 我 们 束 学 习 一 下 到 研 如 何在 程序 运行 的 时 候 申请 权限 。 


7.2.2 ”在 程序 运行 时 申请 权限 


首先 新 建 一 个 RuntimePermissionTest 项 目 ， 我 们 就 在 这 个 项 目的 基础 上 来 学 
习 运 行 时 权限 的 使 用 方法 。 在 开始 动手 之 前 还 需要 考虑 一 下 到 底 要 申请 什 
么 权限 ， 其 实 刚才 表 中 列 出 的 所 有 权限 都 是 可 以 申请 的 ， 这 里 简单 起 见 我 
们 就 使 用 cALL_PHoNE 这 个 权限 来 作为 本 小 下 中 的 示例 吧 。 


CALL_PHONE 这 个 权限 是 编写 拨打 电话 功能 的 时 候 需 要 声明 的 ， 因 为 拨打 电 
话 会 涉及 用 户 手机 的 资费 问题 ， 因 而 被 列 为 了 和 危险 权限 。 在 Android 6.0 系 统 
出 现 之 前 ， 拨 打 电 话 功能 的 实现 其 实 非常 简单 ， 修 改 activity_main.xml 布 局 
文件 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/make_call" 
android:layout_width="match_parent" 


android:layout_height="wrap_content" 
android:text="Make Call" /> 


</LinearLayout> 


我 们 在 布局 文件 中 只 是 定义 了 一 个 按钮 ， 当 点 击 按钮 时 就 去 触发 拨打 电话 
的 逻辑 。 接 着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


Q@Override 
protected void onCreate(Bundle savedIinstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
Button makeCall = (Button) findViewById(R.id.make_ call); 
makeCall.setonClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
try { 
Intent intent = new Intent(Intent.ACTION_ CALL); 
intent.setData(Uri.parse("tel:10086")); 
startActivity(intent); 
} catch (SecurityException e) { 
e.printSstackTrace( ); 


站 7) 


| | 


可 以 看 到 ， 在 按钮 的 点 击 事 件 中 ， 我 们 构建 了 一 个 隐 式 Intent ，Intent 的 
action 指 定 为 Intent .ACTION_CALL ， 这 是 一 个 系统 内 置 的 打 电 话 的 动作 ， 然 
后 在 data 部 分 指定 了 协议 是 tel， 号 码 是 10086。 其 实 这 部 分 代码 我 们 在 2.3.3 
小 节 中 就 已 经 见 过 了 ， 只 不 过 当时 指定 的 action 是 Intent .ACTION_DIAL ， 表 
示 打 开 拨 号 界面 ， 这 个 是 不 需要 声明 权限 的 ， 而 Intent .ACTION_CALL 则 可 
以 直接 拨打 电话 ， 因 此 必须 声明 权限 。 另 外 为 了 防止 程序 裔 尝 ， 我 们 将 所 
有 控 作 都 放 在 了 异常 捕获 代码 块 当中 。 


那么 接 下 来 修改 AndroidManifest.xml 文 件 ， 在 其 中 声明 如 下 权限 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.runtimepermissiontest"> 


<uses-permission android:name="android,.permission.CALL_PHONE" /> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl1="true" 
android:theme="@style/AppTheme"> 


</application> 


</manifest> 


这 样 我们 束 将 拨打 电话 的 功能 成 功 实现 了 ， 并 且 在 低 于 Android 6.0 系 统 的 手 
机 上 都 是 可 以 正常 运行 的 ， 但 是 如 采 我 们 在 6.0 或 者 更 高 版 本 系统 的 手机 上 
和 运行， 点击 Make Call 按 钮 就 没有 任何 效果 ， 这 时 观察 logcat 中 的 打印 日 志 ， 
你 会 看 到 如 图 7.4 所 示 的 错误 信息 。 


java. lang. SecurityException: Permission Denial: starting Intent { act=android. intent. action. CALL 


at android. os. Parcel. readException!( ) 

at android. os. Parcel. readException\( ) 

at android. app. ActivityManagerProxy. startActivity (ActivityManagerNative. java:2658) 

at android. app. Instrumentation. execStartActivity( ) 

at android. app. Activity. startActivityForResult ( ) 

at android. app. Activity. startActivityForResult ( ) 

at android. support. v4. app. FragmentActivity. startActivityForResult ( ) 
at android. app. Activity. startActivity( ) 

at android. app. Activity. StartActivity( ) 


at com. example. runtimepermissiontest. MainaActivityS$S1l. onClick (Jfai 


图 7.4 错误 日 志 信 息 


关 误 信息 中 提醒 我 们 “Permission Denial”， 可 以 看 出 ， 是 由 于 权限 被 禁止 所 
导致 的 ， 因 为 6.0 及 以 上 系统 在 使 用 危险 权限 时 都 必须 进行 运行 时 权限 处 
理 。 


那么 下 面 我 们 束 来 洗 试 修复 这 个 问题 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 
人 小: 


public class MainActivity extends AppCompatActivity { 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
SetContentView(R. Layout,activity_main) ， 
Button makeCall = (Button) findViewById(R.id.make call); 
makeCall.setonCclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 

If (ContextCompat.checkSelfPpermission(MainActivity.this, Manifest. 
permission.CALL_PHONE) != PackageManager .PERMISSION GRANTED) { 
ActivityCompat.requestPermissions(MainActivity.this, new 

String[]{ Manifest.permission.CALL_PHONE }, 1); 

} else { 

call(); 


private void call() { 


try { 
Intent intent = new Intent(Intent.ACTION_CALL); 


intent.setData(Uri.parse("tel:10086")); 


startActivity(intent); 
} catch (SecurityException e) { 
e,printStackTrace( ); 


} 
} 


QOverride 

public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 


case 1: 
If (grantResults. length > 0 && grantResults[0] == PackageManager. 


PERMISSION_GRANTED) { 
call(); 


} else { 
Toast.makeText(this, "You denied the permission", Toast.LENGTH_ 


SHORT). show( ); 
} 
break; 
default: 


上 面 的 代码 将 运行 时 权限 的 完整 流程 都 覆盖 了 ， 下 面 我 们 来 具体 解析 一 
下 。 说 白 了 ， 运 行 时 权限 的 核心 就 是 在 程序 运行 过 程 中 由 用 户 授权 我 们 去 
执行 某 些 危 险 操 作 ， 程 序 是 不 可 以 擅自 做 主 去 执行 这 些 危险 操作 的 。 

此 ， 第 一 步 束 是 要 先 判 断 有 用户 是 不 是 已 经 给 过 我 们 授权 了 ， 借 助 的 是 
ContextCompat.checkSelfPermission() 方法 。 checkSelfPermission() 方法 
接收 两 个 参数 ， 第 一 个 参数 是 context ， 这 个 没什么 好 说 的 ， 第 二 个 参数 是 
具体 的 权限 名 ， 比 如 打 电 话 的 权限 名 束 是 Manifest .permission.CALL_PHONE 
， 然 后 我 们 使 用 方法 的 返回 值 和 packageManager .PERMISSION_GRANTED 做 比 
较 ， 相 等 就 说 明 用 户 已 经 授权 ， 不 等 束 表 示 用 户 没有 授权 。 


如 果 已 经 授权 的 话 束 简单 了 ， 直 接 去 执行 拨打 电话 的 逻辑 操作 就 可 以 了 ， 
这 里 我 们 把 拨打 电话 的 逻辑 封装 到 了 call( ) 方法 当中 。 如 果 没 有 授权 的 
话 ， 则 需要 调用 Activitycompat .requestPermissions() 方法 来 向 用 户 申 请 
授权 ， requestPermissions() 方法 接收 3 个 参数 ， 第 一 个 参数 要 求 是 Activity 
的 实例 ， 第 二 个 参数 是 一 个 string 数组 ， 我 们 把 要 申请 的 权限 名 放 在 数组 
中 即 可 ， 第 三 个 参数 是 请 求 码 ， 只 要 是 唯一 值 就 可 以 了 ， 这 里 传 入 了 1。 


调用 完了 requestPermissions() 方法 之 后 ， 系 统 会 弹出 一 个 权限 申请 的 对 话 
框 ， 然 后 用 户 可 以 选择 同意 或 拒绝 我 们 的 权限 申请 ， 不 论 是 哪 种 结果 ， 最 
终 都 会 回调 到 onRequestPermissionsResult() 方法 中 ， 而 授权 的 结果 则 会 封 
装 在 grantResults 参数 当中 。 这 里 我 们 只 需要 判断 一 下 最 后 的 授权 结果 ， 

如 果 用 户 同意 的 话 就 调用 cal1() 方法 来 拨打 电话 ， 如 果 用 户 拒绝 的 话 我 们 
只 能 放弃 操作 ， 并 且 弹 出 一 条 失败 提示 。 


现在 重新 运行 一 下 程序 ， 并 点 击 Make Call 按 钮 ， 效 果 如 图 7.5 所 示 。 


EC Allow RuntimePermis 
sionTest to make and 
manage phone calls? 


DENY ALLOW 


图 7.5 申请 电话 权限 对 话 框 

由 于 用 户 还 没有 授权 过 我 们 拨打 电话 权限 ， 因 此 第 一 次 运行 会 弹出 这 样 一 
个 权限 申请 的 对 话 框 ， 用 户 可 以 选择 同意 或 者 拒绝 ， 比 如 说 这 里 点 击 了 
DENY， 结 果 如 图 7.6 所 示 。 


RuntimePermissionTest 


MAKE CALL 


You denied the permission 


图 7.6 用 户 拒绝 了 权限 申请 


由 于 用 户 没 有 同意 授权 ， 我 们 只 能 弹出 一 个 操作 失败 的 提示 。 下 面 我 们 再 
次 点 击 Make Call 按 钮 ， 仍 然 会 弹出 权限 申请 的 对 话 框 ， 这 次 点 击 ALLOW， 
结果 如 图 7.7 所 示 。 


图 7.7 拨打 电话 界面 


可 以 看 到 ， 这 次 我 们 就 成 功 进 入 到 拨打 电话 界面 了 ， 并 且 由 于 用 户 已 经 完 
成 了 授权 操作 ， 之 后 再 点 击 Make Call 按 钮 就 不 会 再 弹出 权限 申请 对 话 框 
了 ， 而 是 可 以 直接 拨打 电话 。 那 可 能 你 会 担心 ， 万 一 以 后 我 义 后 悔 了 和 霞 么 
办 ? 没有 关系 ， 用 户 随 时 都 可 以 将 授予 程序 的 危险 权限 进行 关闭 ， 进 入 
Settings Apps -~ RuntimePermissionTest -~ Permissions， 界 面 如 图 7.8 所 
起 °5 


€ Apppermissions 


上 RuntimePermissionTest 


图 7.8 ”应 用 程序 权限 管理 界面 
在 这 里 我 们 就 可 以 对 任何 授予 过 的 危险 权限 进行 天 闭 了 。 


好 了 ， 关 于 运行 时 权限 的 内 容 就 讲 到 这 里 ， 现 在 你 已 经 有 能 力 处 理 Android 
上 各 种 关于 权限 的 问题 了 ， 下 面 我 们 束 来 进入 本 章 的 正题 一 一 内 容 提供 
器 。 


7.3 ”访问 其 他 程序 中 的 数据 


内 容 提供 状 的 用 法 一 般 有 两 种 ， 一 种 是 使 用 现 有 的 内 容 提供 各 来 读 取 和 操 
作 相 应 程序 中 的 数据 ， 另 一 种 是 创建 自己 的 内 容 提 供 器 给 我 们 程序 的 数据 
提供 外 部 访问 接口 。 那 么 接 下 来 我 们 束 一 个 一 个 开始 学 习 吧 ， 甫 和 完 从 使 用 
现 有 的 内 容 提 供 各 开始 。 


如 采 一 个 应 用 程序 通过 内 容 提供 器 对 其 数据 提供 了 外 部 访问 接口 ， 那 么 任 
何其 他 的 应 用 程序 束 都 可 以 对 这 部 分 数据 进行 访问 。 0 
电话 簿 、 短 信 、 媒 体 库 等 程序 都 提供 了 类 似 的 访 间接 口 ， 这 束 使 得 第 二 

应 用 程序 可 以 充分 地 利用 这 部 分 数据 来 实现 更 好 的 功能 。 下 面 我 们 束 未 和 
一 看 ， 内 容 提 供 右 到 说 是 如 何 使 用 的 。 


7.3.1 ”ContentResolver 的 基本 用 法 


对 于 每 一 个 应 用 程序 来 说 ， 如 果 想 要 访问 内 容 提供 器 中 共享 的 数据 ， 束 一 
定 要 借助 ContentResolver 类 ， 可 以 通过 Context 中 的 getcontentResolver() 方 
法 获取 到 该 类 的 实例 。ContentResolver 中 提供 了 一 系列 的 方法 用 于 对 数据 进 
行 CRUD 操 作 ， 其 中 insert() 方法 用 于 添加 数据 ，update() 方法 用 于 更 新 
数据 ，delete() 方法 用 于 删除 数据 ，query() 方法 用 于 查询 数据 。 有 没有 似 
曾 相识 的 感觉 ? 没 错 ，SQLiteDatabase 中 也 是 使 用 这 几 个 方法 来 进行 CRUD 
操作 的 ， 只 不 过 它们 在 方法 参数 上 稍微 有 一 些 区 别 。 


不 同 于 SQLiteDatabase，ContentResolver 中 的 增删 改 查 方法 都 是 不 接收 表 名 
参数 的 ， 而 是 使 用 一 个 uri 参数 代替 ， 这 个 参数 被 称 为 内 容 URI。 内 容 URI 
给 内 容 提 供 器 中 的 数据 建立 了 唯一 标识 从 ， 它 主要 由 两 部 分 组 成 : authority 
和 path 。 authority 是 用 于 对 不 同 的 应 用 程序 做 区 分 的 ， 一 般 为 了 避免 冲突 ， 
都 会 采用 程序 包 名 的 方式 来 进行 命名 。 比 如 某 个 程序 的 包 名 是 
com.example.app， 那 么 该 程序 对 应 的 authority 束 可 以 命名 为 
com.example.app.provider。path 则 是 用 于 对 同一 应 用 程序 中 不 同 的 表 做 区 分 
的 ， 通 常 都 会 添加 到 authority 的 后 面 。 比 如 某 个 程序 的 数据 库 里 存在 两 张 
表 : table1 和 table2， 这 时 就 可 以 将 path 分 别 命名 为 /table1 和 /table2， 然 后 把 
authority 和 path 进 行 组 合 ， 内 容 URI 束 变 成 了 com.example.app.providertablel 
和 com.example.app.providertable2。 不 过 ， 目 前 还 很 难 辨认 出 这 两 个 字符 串 
就 是 两 个 内 容 URI， 我 们 还 需要 在 字符 串 的 头 部 加 上 协议 声明 。 因 此 ， 内 容 
URI 最 标准 的 格式 写法 如 下 : 


content://com.example.app.provider/table1 
content://com.example.app.provider/table2 


有 没有 发 现 ， 内 容 URI 可 以 非常 清楚 地 表达 出 我 们 想 要 访问 哪个 程序 中 哪 张 

表 里 的 数据 。 也 正 是 因此 ，ContentResolver 中 的 增删 改 碍 方法 才 都 接收 uri 

对 和 象 作为 参数 ， 因为 如 采 使 用 表 名 的 话 ， 系 统 将 无 法 得 知 我 们 期 望 访问 的 
是 哪 个 应 用 程序 里 的 表 。 


在 得 到 了 内 容 URI 字 符 串 之 后 ， 我 们 还 需要 将 它 解析 成 uri 对象 才 可 以 作为 
参数 传 入 。 解 析 的 方法 也 相当 简单 ， 代 码 如 下 所 示 : 


Uri uri = Uri.parse("content://com.example.app.provider/table1") 


只 需要 调用 uri.parse() 方法 ， 就 可 以 将 内 容 URI 字 符 串 解析 成 uri 对 象 
了 了 bs 


现在 我 们 不可 以 使 用 这 个 uri 对 象 来 查询 tablel 表 中 的 数据 了 ， 代 码 如 下 所 
人 小 : 


Cursor cursor = getContentResolver().query( 
uri, 


projection, 
selection, 
selectionArgs, 
sortorder); 


这 些 参数 和 SQLiteDatabase 中 query() 方法 里 的 参数 很 像 ， 但 总 体 来 说 要 侧 
单一 些 ， 毕 竟 这 是 在 访问 其 他 程序 中 的 数据 ， 没 必要 构建 过 于 复杂 的 查询 
语句 。 下 表 对 使 用 到 的 这 部 分 参数 进行 了 详细 的 解释 。 


query() 方 法 参数 对 应 SQL 部 分 
Wi 


selectionArgs 大 吕 的 占 位 符 提供 具体 的 值 


sortorder order by column1，column2 询 结果 的 排序 方式 


查询 完成 后 返回 的 仍然 是 一 个 cursor 对 象 ， 这 时 我 们 就 可 以 将 数据 从 
cursor 对 象 中 逐个 读 取出 来 了 。 读 取 的 思路 仍 人 是 通过 移动 游标 的 位 置 来 
遇 历 cursor 的 所 有 行 ， 然 后 再 取出 每 一 行 中 相应 列 的 数据 ， 代 码 如 下 所 
人 小: 


if (cursor != null) { 
while (cursor.moveToNext()) { 
String column1 = cursor.getSstring(cursor.getCcolumnIindex("column1")); 
int column2 = cursor.getIint(cursor.getColumnIndex("column2")); 


cursor.close(); 


} 


掌握 了 最 难 的 查询 操作 ， 剩 下 的 增加 、 修改 、 删 除 操作 束 更 不 在 话 下 了 。 
我 们 先 来 看 看 如 何 向 tablel 表 中 添加 一 条 数据 ， 代 码 如 下 所 示 : 


ContentValues values = new ContentValues(); 
values.put("column1i", "text"); 
values.put("column2", 1); 
getCcontentResolver().insert(uri, values); 


可 以 看 到 ， 仍 然 是 将 竺 添加 的 数据 组 装 到 ContentValues 中 ， 然 后 调用 
ContentResolver 的 insert() 方法 ， 将 Uri 和 ContentValues 作 为 参数 传 入 即 
可 。 


现在 如 有 果 我 们 想 要 更 狐 这 条 新 添加 的 数据 ， 把 column1 的 值 清 空 ， 可 以 借助 
ContentResolver 的 update( ) 方法 实现 ， 代 码 如 下 所 示 : 


ContentValues values = new ContentValues(); 

values.put("column1" SS 

SetContentResolver 0: update( uri, values, "columni = ? and column2 = ?", new 
String[] {"text", "1"}); 


生意 上 述 代码 使 用 了 selection 和 selectionArgs 参数 来 对 想 要 更 新 的 数据 
进行 约束 ， 以 防止 所 有 的 行 都 会 受 影响 。 


最 后 ， 可 以 调用 ContentResolver 的 delete() 方法 将 这 条 数据 删除 掉 ， 代 码 如 
下 所 示 : 


My 
Y 
、 


getContentResolver().delete(uri, "column2 = ?", new String[] { "1" }); 


到 这 里 为 止 ， 我 们 就 把 ContentResolver 中 的 增删 改 查 方法 全 部 学 完了 。 是 不 
是 感觉 一 看 就 懂 ? 因 为 这 些 知识 早 在 上 一 章 中 学 习 SQLiteDatabase 的 时 候 你 
就 已 经 掌握 了 ， 所 需 特 别 注意 的 就 只 有 uri 这 个 参数 而 已 。 那 么 接 下 来 ， 我 
们 就 利用 目前 所 学 的 知识 ， 看 一 看 如 何 读 取 系 统 电 话 筹 中 的 联系 人 信息 。 


7.3.2 ” 读 取 系统 联系 人 


由 于 我 们 之 前 一 直 使 用 的 都 是 模拟 器 ， 电 话 敌 里 面 并 没有 联系 人 存在 ， 所 
ER 目 己 手动 添加 几 个 ， 以 便 稍 后 进行 读 取 。 打 开 电 话 短程 序 ， 界 
0 终 7.9BT 不 。 


ADD A CONTACT 


图 7.9 电话 薄 程 序 主 界面 


可 以 看 到 ， 目 前 电话 筹 里 是 没有 任何 联系 人 的 ， 我 们 可 以 通过 点 击 ADD A 
CONTACT 按 钮 来 对 联系 人 进行 创建 。 这 里 就 先 创建 两 个 联系 人 吧 ， 分 别 填 
入 他 们 的 姓名 和 手机 号 ， 如 图 7.10 所 示 。 


Add new contact Add new contact 


John 


Tom 


(098) 765-4321 


\。 1234-567-890| 


More Fields 


More Fields 


图 7.10 添加 两 个 联系 人 


这 样 准备 工作 就 做 好 了 ， 现 在 新 建 一 个 ContactsTest 项 目 ， 让 我 们 开始 动手 
吧 。 


首先 还 是 来 编写 一 下 布局 文件 ， 这 里 我 们 希望 读 取 出 来 的 联系 人 信息 能 够 
在 ListView 中 显示 ， 因 此 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<ListView 
android:id="@+id/contacts_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


</ListView> 


</LinearLayout> 


人 简单 起 见 ，LinearLayout 里 就 只 放置 了 一 个 ListView。 这 里 使 用 ListView 而 不 


是 RecyclerView， 是 因为 我 们 要 将 关注 的 重点 放 在 读 取 系统 联系 人 上 面 ， 如 
果 使 用 RecyclerView 的 话 ， 代 码 偏 多 ， 会 容易 让 我 们 找 不 着 重点 。 


接着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


ArrayAdapter<String> adapter ; 
List<String> contactsList = new ArrayList<>(); 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
Super .oncCreate(SavedInstanceState ) 
setcontentView(R.1layout.activity_main); 
ListView contactsView = (ListView) findViewById(R.id.contacts_ view); 
adapter = new ArrayAdapter<String>(this, android.R.layout. simple_list_ 
item 1, contactsList); 
contactsView.setAdapter (adapter ) ， 
if (ContextCompat.checkSelfPpermission(this, Manifest.permission.READ_ 
CONTACTS) != PackageManager .PERMISSION_ GRANTED) { 
ActivityCompat.requestPermissions(this, new String[]{ Manifest. 
permission.READ_CONTACTS }, 1); 
} else { 
readContacts(); 
} 


} 


private void readContacts() { 
Cursor cursor = null; 
try { 
// 查询 联系 人 数据 
cursor = getContentResolver().query(ContactsContract.CommonDatakinds. 
Phone.CONTENT_URI, null, null, null, null); 
if (cursor != null) { 
while (cursor.moveToNext()) { 
// 获取 联系 人 姓名 
String displayName = cursor.getString(cursor.getColumnIndex 
(ContactsContract.CommonDatakinds.Phone.DISPLAY_NAME)); 
// 获取 联系 人 手机 号 
String number = cursor.getString(cursor .getCcolumnIndex 
(ContactsContract .CommonDataKkinds ,Phone .NUMBER ) ) ， 
contactsList.add(displayName + "\n" + number ) ， 


} 
adapter .notifyDataSetChanged() ， 


} 
} catch (Exception e) { 
e,printStackTrace( ); 
} finally { 
if (cursor != null) { 
cursor.close( ); 
} 


} 


QOverride 
public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 
case 1: 
If (grantResults. length > 0 && grantResults[0] == PackageManager. 
PERMISSION_GRANTED) { 
readcontacts(); 
} else { 
Toast.makeText(this, "You denied the permission", Toast.LENGTH_ 
SHORT). show( ); 


break; 
default: 


在 oncreate( ) 方法 中 ， 我 们 首先 获取 了 ListView 控 件 的 实例 ， 并 给 它 设 置 好 


了 适配器 ， 然 后 开始 调用 运行 时 权限 的 处 理 逻 辑 ， 因 为 READ_CONTACTS 
权限 是 属于 危险 权限 的 。 关 于 运行 时 权限 的 处 理 流 程 相 信 你 已 经 熟练 掌握 
了 ， 这 里 我 们 在 用 户 授 权 之 后 调用 readcontacts() 方法 来 读 取 系统 联系 人 


I 
信息 。 


下 面 重 点 看 一 下 readcontacts() 方法 ， 可 以 看 到 ， 这 里 使 用 了 
ContentResolver 的 query() 方法 来 查询 系统 的 联系 人 数据 。 不 过 传 入 的 uri 
参数 怎么 有 些 奇 怪 啊 ? 为 什么 没有 调用 uri.parse() 方法 去 解析 一 个 内 容 
URI 字 符 串 昵 ? 这 是 因为 contactscontract.commonDataKinds.Phone 类 已 经 
帮 有 我 们 做 好 了 封装 ， 提 供 了 一 个 coNTENT_URI 常量 ， 而 这 个 常量 就 是 使 用 
uri.parse() 方法 解析 出 来 的 结果 。 接 着 我 们 对 cursor 对 象 进行 笛 历 ， 将 联 
系 人 姓名 和 手机 号 这 些 数据 逐个 取出 ， 联 系 人 姓名 这 一 列 对 应 的 常量 是 
ContactsContract.CommonDatakinds.Phone.DISPLAY_NAME, 联系 人 手机 号 这 
一 列 对 应 的 常量 是 contactscontract .CommonDatakinds .Phone.NUMBER 8 两 个 
数据 都 取出 之 后 ， 将 它们 进行 拼接 ， 并 且 在 中 间 加 上 换行 符 ， 然 后 将 拼接 
后 的 数据 添加 到 ListView 的 数据 源 里 ， 并 通知 刷新 一 下 ListView。 最 后 干 万 
不 要 起 记 将 cursor 对 象 天 闭 掉 。 


这 样 就 结束 了 吗 ? 还 差 一 点 点 ， 读 取 系 统 联系 人 的 权限 千 万 不 能 乐 记 声 
明 。 修 改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.contactstest"> 


<uses-permission android:name="android,permission,.READ_CONTACTS"” /> 


</manifest> 


加 入 了 android. permission.READ_CONTACTS 权限 ， 这 样 我 们 的 程序 就 可 以 访 
问 到 系统 的 联系 人 数据 了 “。 现 在 才 算是 大 功 告 成 了 ， 让 我 们 来 运行 一 下 程 
序 吧 ， 效 果 如 图 7.11 所 示 。 


EE Allow ContactsTest to 
access your contacts? 


DENY ALLOW 


图 7.11 申请 访问 联系 人 权限 对 话 框 


首先 弹出 了 申请 访问 联系 人 权限 的 对 话 框 ， 我 们 点 击 ALLOW， 然 后 结果 如 
图 7.12 所 示 。 


ww 区 5:41 


ContactsTest 


John 
(098) 765-4321 


om 
1 234-567-890 


图 7.12 展示 系统 联系 人 信息 


刚刚 添加 的 两 个 联系 人 的 数据 都 成功 读 取 出 来 了 ! 这 说 明 跨 程序 访问 数据 
的 功能 确实 是 实现 了 。 


7.4 ”创建 自己 的 内 容 提 供 融 


在 上 一 节 当 中 ， 我 们 学 习 了 如 何在 自己 的 程序 中 访问 其 他 应 用 程序 的 数 
据 。 总 体 来 说 思路 还 是 非常 简单 的 ， 只 需要 获取 到 该 应 用 程序 的 内 容 URL， 
然后 借助 ContentResolver 进 行 CRUD 操 作 就 可 以 了 。 可 是 你 有 没有 想 过 ， 那 
些 提 供 外 部 访问 接口 的 应 用 程序 都 是 如 何 实现 这 种 功能 的 呢 ? 它们 又 是 怎 
样 保证 数据 的 安全 性 ， 使 得 隐私 数据 不 会 泄漏 出 去 ? 学 习 完 本 下 的 知识 
后 ， 你 的 疑惑 将 会 彼 一 一 解 开 。 


7.4.1 创建 内 容 提供 器 的 步 又 


前 面 已 经 提 到 过 ， 如 有 果 想 要 实现 跨 程序 共享 数据 的 功能 ， 官 方 推荐 的 方式 
瓯 是 使 用 内 容 提 供 右 ， 可 以 通过 新 建 一 个 类 去 继承 contentProvider 的 方式 
来 创建 一 个 自己 的 内 容 提供 器 。contentProvider 类 中 有 6 个 抽象 方法 ， 我 
们 在 使 用 子 类 继承 它 的 时 候 ， 需要 将 这 6 个 方法 全 部 重 写 。 新 建 MyProvider 
继承 自 contentProvider ， 代 码 如 下 所 示 : 


public class MyProvider extends ContentProvider { 


Q@Override 

public boolean onCreate() { 
return false; 

} 


QOverride 

public Cursor query(Uri uri, String[] projection, String selection, String[] 
selectionArgs, String sortOrder) { 
return null; 


} 


Q@Override 

public Uri insert(Uri uri, ContentValues values) { 
return null; 

} 


QOverride 

public int update(Uri uri, ContentValues values, String selection, String[] 
selectionArgs) { 
return 0); 


} 


Q@Override 

public int delete(Uri uri, String selection, String[] selectionArgs) { 
return 0); 

} 


QOverride 

public String getType(Uri uri) { 
return null; 

} 


在 这 6 个 方法 中 ， 相 信 大 多 数 你 都 已 经 非常 熟悉 了 ， 我 再 来 简单 介绍 一 下 


吧 。 


01. oncreate() 


初始 化 内 容 提供 占 的 时 候 调用 。 通 常会 在 这 里 完成 对 数据 库 的 创建 和 
升级 等 操作 ， 返 回 true 表示 内 容 提供 夯 初 始 化 成 功 ， 返 回 false 则 表示 
失败 。 


02. query() 


从 内 容 提供 器 中 查询 数据 。 使 用 uri 参数 来 确定 查询 哪 张 表 ， 
projection 参数 用 于 确定 查询 哪些 列 ， selection 和 selectionArgs 参 
数 用 于 约束 查询 哪些 行 ，sortorder 参数 用 于 对 结果 进行 排序 ， 查 询 的 
结果 存放 在 cursor 对 象 中 返回 。 


0 


UL 


.Insert() 


向 内 容 提 供 器 中 添加 一 条 数据 。 使 用 uri 参数 来 确定 要 添加 到 的 表 ， 待 
添加 的 数据 保存 在 values 参数 中 。 添 加 完成 后 ， 返 回 一 个 用 于 表示 这 
条 新 记录 的 URI。 


04. update( ) 


更 新 内 容 提供 器 中 已 有 的 数据 。 使 用 uri 参数 来 确定 更 新 哪 一 张 表 中 的 
数据 ， 新 数据 保存 在 values 参数 中 ， selection 和 selectionArgs 参数 
用 于 约束 更 新 哪些 行 ， 受 影响 的 行 数 将 作为 返回 值 返回 。 


05. delete() 


从 内 容 提 供 器 中 删除 数据 。 使 用 uri 参数 来 确定 删除 哪 一 张 表 中 的 数 
据 ，selection 和 selectionArgs 参数 用 于 约束 删除 哪些 行 ， 被 删除 的 
行 数 将 作为 返回 值 返回 。 


06. getType() 
根据 传 入 的 内 容 URI 来 返回 相应 的 MIME 类 型 。 
可 以 看 到 ， 几 乎 每 一 个 方法 都 会 带 有 uri 这 个 参数 ， 这 个 参数 也 正 是 调用 
ContentResolver 的 增删 改 查 方法 时 传递 过 来 的 。 而 现在 ， 我 们 需要 对 传 入 的 
uri 参数 进行 解析 ， 从 中 分 析出 调用 方 期 望 访问 的 表 和 数据 。 


回顾 一 下 ， 一 个 标准 的 内 容 URI 写 法 是 这 样 的 ; 


content://com.example.app.provider/table1 


这 就 表示 调用 方 期 望 访问 的 是 com.example.app 这 个 应 用 的 tablel 表 中 的 数 
据 。 除 此 之 外 ， 我 们 还 可 以 在 这 个 内 容 URI 的 后 面 加 上 一 个 id， 如 下 所 示 : 


content://com.example.app.provider/table1/1 


这 就 表示 调用 方 期 望 访问 的 是 com.example.app 这 个 应 用 的 tablel 表 中 id 为 1 的 
数据 。 


内 容 URI 的 格式 主要 整 只 有 以 上 两 种 ， 以 路 径 结 尾 束 表示 期 望 访问 该 表 中 所 
有 的 数据 ， 以 id 结 尾 束 表示 期 望 访问 该 表 中 拥有 相应 id 的 数据 。 我 们 可 以 使 
用 通配符 的 方式 来 分 别 匹 配 这 两 种 格式 的 内 容 URI， 规 则 如 下 。 

。*: 表示 匹配 任意 长 度 的 任意 字符 。 

。#: 表示 匹配 任意 长 度 的 数字 。 


所 以 ， 一 个 能 够 匹配 任意 表 的 内 容 URI 格 式 就 可 以 写成 : 


content://com.example.app.provider/* 


而 一 个 能 够 匹配 tablel 表 中 任意 一 行 数据 的 内 容 URI 格 式 就 可 以 写成 : 


content://com.example.app.provider/table1/# 


接着 ， 我 们 再 借助 UriMatcher 这 个 类 就 可 以 轻松 地 实现 匹配 内 容 URI 的 功 

能 。UriMatcher 中 提供 了 一 个 adduRI() 方法 ， 这 个 方法 接收 3 个 参数 ， 可 以 
分 别 把 authority 、path 和 一 个 目 定 义 代 码 传 进 去 。 这 样 ， 当 调用 
UriMatcher 的 match() 方法 时 ， 束 可 以 将 一 个 uri 对 象 传 入 ， 返 回 值 是 某 个 
能 够 匹配 这 个 uri 对 象 所 对 应 的 目 定义 代码 ， 利 用 这 个 代码 ， 我 们 就 可 以 判 
条 调用 方 期 望 访问 的 是 哪 张 表 中 的 数据 了 。 修 改 MyProvider 中 的 代码 ， 如 
下 所 示 : 


public class MyProvider extends ContentProvider { 


public static final int TABLE1 DIR = 0; 


public static final int TABLE1 ITEM = 1; 


public static final int TABLE2_DIR = 2; 
public static final int TABLE2_ITEM = 3; 
private static UriMatcher uriMatcher,; 


static { 
uriMatcher = new UriMatcher (UriMatcher .NO_MATCH); 
uriMatcher.addURI("com.example.app.provider", "table1", TABLE1 DIR); 
uriMatcher.addURI("com.example.app.provider ", "table1i/#", TABLE1_ ITEM); 
uriMatcher .addURI("com.example.app.provider ", "table2", TABLE2_DIR); 
uriMatcher.addURI("com.example.app.provider ", "table2/#", TABLE2_ITEM); 


QOverride 
public Cursor query(Uri uri, String[] projection, String selection, String[] 
selectionArgs, String sortOrder) { 
Switch (uriMatcher.match(uri)) { 
case TABLE1_DIR: 
// 查询 table1 表 中 的 所 有 数据 
break; 
case TABL 
// 查 
break 
case TABL 
// 查 
break 
case TABL 
// 查 
break; 
default: 
break; 


芋 


1_ITEM: 
tab1le1 表 中 的 单条 数据 


2_DIR: 
table2 表 中 的 所 有 数据 


2_ITEM: 
table2 表 中 的 单条 数据 


下 mm、 要 mm、: 村 m、 


可 以 看 到 ，MyProvider 中 新 增 了 4 个 整 型 常量 ， 其 中 TABLE1_DIR 表示 访问 
tablel 表 中 的 所 有 数据 ，TABLE1_ITEM 表示 访 问 tablel 表 中 的 单条 数据， 
TABLE2_DIR 表示 访问 table2 表 中 的 所 有 数据 ，TABLE2_ITEM 表示 访问 table2 表 
中 的 单条 数据 。 接 着 在 静态 代码 块 里 我 们 创建 了 UriMatcher 的 实例 ， 并 调用 
addUuRI( ) 方法 ， 将 期 望 匹 配 的 内 容 URI 格 式 传递 进去 ， 注 意 7 
参数 是 可 以 使 用 通配符 的 。 然 后 当 query( ) 方法 被 调用 的 时 候 ， 就 会 通 
UriMatcher 的 match( ) 方法 对 传 入 的 uri 对 象 进行 匹配 ， 0 
中 某 个 内 容 URI 格 式 成 功 匹 配 了 该 uri 对 象 ， 则 会 返回 相应 的 自 定义 代码 ， 
然后 我 们 吏 可 以 判断 出 调用 方 期 望 访问 的 到 确 是 什么 数据 了 。 


上 述 代码 只 是 以 query() 方法 为 例 做 了 个 示范 ， 其 实 insert() 、update() 、 
delete() 这 几 个 方法 的 实现 也 是 差不多 的 ， 它 们 都 会 携带 uri 这 个 参数 ， 然 
后 同样 利用 UriMatcher 的 match() 方法 判断 出 调用 方 期 望 访问 的 是 哪 张 表 ， 
再 对 该 表 中 的 数据 进行 相应 的 操作 束 可 以 了 。 


除 此 之 外 ， 还 有 一 个 方法 你 会 比较 阳 生 ， 即 getType() 方法 。 它 是 所 有 的 内 
容 提 供 如 都 必须 提供 的 一 个 方法 ， 用 于 获取 uri 对 象 所 对 应 的 MIME 类 型 。 
一 个 内 容 URI 所 对 应 的 MIME 字 符 串 主要 由 3 部 分 组 成 ，Android 对 这 3 个 部 分 
做 了 如 下 格式 规定 。 


。 必须 以 vnd 开头 。 


。 如 采 内 容 URI 以 路 径 结尾 ， 则 后 接 android.cursor.dir/ ， 如 果 内 容 URI 
以 id 结尾 ， 则 后 接 android.cursor .itemy 8 


。 最 后 接 上 vnd. <authority>.<path> ° 


所 以 ， 对 于 content://com.example.app.provider/tablel 这 个 内 容 URI， 它 所 对 
应 的 MIME 类 型 就 可 以 写成 ; 


vnd.android.cursor.dir/vnd.com.example.app.provider.tablel1 


对 于 content://com.example.app.provider/table1/1 这 个 内 容 URI， 它 所 对 应 的 
MIME 类 型 就 可 以 写成 : 


vnd.android.cursor.item/vnd.com.example.app.provider.table1i 


现在 我 们 可 以 继续 完善 MyProvider 中 的 内 容 了 ， 这 次 来 实现 getType() 方法 
中 的 逻辑 ， 代 码 如 下 所 示 : 


public class MyProvider extends ContentProvider { 


Q@Override 
public String getType(Uri uri) { 
Switch (uriMatcher.match(uri)) { 
case TABLE1_DIR: 
return "vnd.android.cursor.dir/vnd.com.example.app.provider.table1",; 
case TABLE1_ITEM: 


return "vnd.android.cursor.item/vnd.com.example.app.provider.table1"; 
case TABLE2_DIR: 

return "vnd.android.cursor.dir/vnd.com.example.app.provider.table2",; 
case TABLE2_ITEM : 

return "vnd.android.cursor.item/vnd.com.example.app.provider.table2"; 
default: 

break; 


} 
return null; 


到 这 里 ， 一 个 完整 的 内 容 提供 颖 就 创建 完成 了 ， 现 在 任何 一 个 应 用 程序 都 
可 以 使 用 ContentResolver 来 访问 我 们 程序 中 的 数据 。 那 么 前 面 所 提 到 的 ， 如 


何 才能 保证 隐私 数据 不 会 泄漏 出 去 呢 ? 其实 多 亏 了 内 容 提 供 器 的 民 好 机 
制 ， 这 个 问题 在 不 知 不 觉 中 已 经 被 解决 了 。 因 为 所 有 的 CRUD 操 作 都 一 定 要 
匹配 到 相应 的 内 容 URI 格 式 才能 进行 的 ， 而 我 们 当然 不 可 能 同 UriMatcher 中 
添加 隐私 数据 的 URI， 所 以 这 部 分 数据 根本 无 法 被 外 部 程序 访问 到 ， 安 全 问 
题 也 束 不 存在 了 。 


好 了 ， 创 建 内 容 提 供需 的 步 又 你 也 已 经 清楚 了 ， 下 面 承 来 实战 一 下 ， 真 正 
体验 一 回路 程序 数据 共 孚 的 功能 。 


7.4.2 ”实现 跨 程 序数 据 共享 


简单 起 见 ， 我 们 还 是 在 上 一 章 中 DatabaseTest 项 目的 基础 上 继续 开发 ， 通 过 
内 容 提 供需 来 给 它 加 入 外 部 访问 接口 。 打 开 DatabaseTest 项 目 ， 首 移 将 
MyDatabaseHelper 中 使 用 Toast 弹 出 创建 数据 库 成 功 的 提示 去 除 掉 ， 因 为 路 
程序 访问 时 我 们 不 能 直接 使 用 Toast。 然 后 创建 一 个 内 容 提 供 妖 ， 石 击 
com.example.databasetest 包 一 New 一 Other 一 Content Provider， 会 弹出 如 图 
7.13 所 示 的 窗口 。 


ee or i 


(lolalile ld elolol ld 


Android Studio 


Creates a new content provider component and adds it to your Android manifest. 


Class Name: DatabaseProvider 


URI Authorities: com.example.databasetest.provider 


Exported 


BE Enabled 


A semicolon separated list of one or more URI authorities that identify data under the purview of the content provider. 


Finish 


图 7.13 创建 内 容 提供 器 的 窗口 


可 以 看 到 ， 这 里 我 们 将 内 容 提 供 器 命名 为 DatabaseProvider，authority 指定 
为 com.example.databasetest .provider ， Exported 属性 表示 是 否 允 许 外 部 

程序 访问 我 们 的 内 容 提 供 器 ，Enabled 属性 表示 是 否 启用 这 个 内 容 提 供 器 。 

将 两 个 属性 都 义 中 ， 点 击 Finish 完 成 创建 。 


接着 我 们 修改 DatabaseProvider 中 的 代码 ， 如 下 所 示 : 


public class DatabaseProvider extends ContentProvider { 


public static final int BOOK_DIR = 0; 

public static final int BOOK_ITEM = 1; 

public static final int CATEGORY_DIR = 2; 

public static final int CATEGORY_ITEM = 3; 

public static final String AUTHORITY = "com.example.databasetest.provider",; 


private static UriMatcher uriMatcher,; 


private MyDatabaseHelper dbHelper; 


static { 
uriMatcher = new UriMatcher (UriMatcher .NO_MATCH); 
uriMatcher .addURI(AUTHORITY， "book", BOOK_DIR); 
uriMatcher .addURI(AUTHORITY， "book/#", BOOK_ITEM); 
uriMatcher .addURI(AUTHORITY， "category", CATEGORY_DIR); 
uriMatcher .addURI(AUTHORITY， "category/#", CATEGORY_ITEM); 


} 


Q@Override 

public boolean onCreate() { 
dbHelper = new MyDatabaseHelper(getContext(), "BookStore.db", null, 2); 
return true,; 


} 


QOverride 
public Cursor query(Uri uri, String[] projection, String selection, String[] 
selectionArgs, String sortOrder) { 
// 查询 数据 
SQLiteDatabase db = dbHelper .getReadableDatabase(); 
Cursor cursor = null; 
Switch (uriMatcher.match(uri)) { 
case BOOK_DIR: 
cursor = db.query("Book", projection, selection, selectionArgs, null, 
null, sortOrder); 
break; 
case BOOK_ITEM: 
String bookId = uri.getPpathSegments().get(1); 
cursor = db.query("Book", projection, "id = ?", new String[] { bookId }, 
null, null, sortOorder); 
break; 
case CATEGORY_DIR: 
cursor = db.query("Category", projection, selection, selectionArgs, 
null, null, sortOorder); 
break; 
case CATEGORY_ITEM: 
String categoryId = uri.getPathSegments().get(1); 
cursor = db.query("Category", projection, "id = ?", new String[] 
{ categoryId }, null, null, sortoOrder); 
break; 
default: 
break; 


} 


return cursor,; 


} 


QOverride 
public Uri insert(Uri uri, ContentValues values) { 
// 添加 数据 
SQLiteDatabase db = dbHelper .getwritableDatabase(); 
Uri uriReturn = null; 
Switch (uriMatcher.match(uri)) { 
case BOOK_DIR: 
case BOOK_ITEM: 
long newBookId = db.insert("Book", null, values); 
uriReturn = Uri.parse("content://" + AUTHORITY + "/book/" + 
newBookId); 
break; 
case CATEGORY_DIR: 
case CATEGORY_ITEM: 
long newCategoryId = db.insert("Category", null, values); 
uriReturn = Uri.parse("content://" + AUTHORITY + "/category/" + 
newCategoryId ) ， 
break; 
default: 


break; 


} 

return uriReturn; 
} 
QOverride 


public int update(Uri uri, ContentValues values, String selection, String[] 
selectionArgs) { 
// 更 新 数据 
SQLiteDatabase db = dbHelper .getwritableDatabase(); 
int updatedRows = 0; 
Switch (uriMatcher.match(uri)) { 
case BOOK_DIR: 
updatedRows = db.update("Book", values, selection, selectionArgs); 
break; 
case BOOK_ITEM: 
String bookId = uri.getPpathSegments().get(1); 
updatedRows = db.update("Book", values, "id = ?", new String[] 
{ bookId }); 
break; 
case CATEGORY_DIR: 
updatedRows = db.update("Category", values, selection, 
selectionArgs); 
break; 
case CATEGORY_ITEM: 
String categoryId = uri.getPathSegments().get(1); 
updatedRows = db.update("Category", values, "id = ?", new String[] 
{ categoryId }); 


break; 
default: 
break; 
} 
return updatedRows,; 
} 
QOverride 


public int delete(Uri uri, String selection, String[] selectionArgs) { 
// 删除 数据 
SQLiteDatabase db = dbHelper.getwritableDatabase( ) ， 
int deletedRows = 0; 
Switch (uriMatcher.match(uri)) { 
case BOOK_DIR: 
deletedRows = db.delete("Book", selection, selectionArgs); 
break; 
case BOOK_ITEM: 
String bookId = uri.getPpathSegments().get(1); 
deletedRows = db.delete("Book", "id = ?", new String[] { bookId }); 
break; 
case CATEGORY_DIR: 
deletedRows = db.delete("Category", selection, selectionArgs); 
break; 
case CATEGORY_ITEM: 
String categoryId = uri.getPathSegments().get(1); 
deletedRows = db.delete("Category", "id = ?", new String[] 
{ categoryId }); 


break; 
default: 
break; 
J 
return deletedRows; 
3 
QOverride 


public String getType(Uri uri) { 
Switch (uriMatcher.match(uri)) { 
case BOOK_DIR: 


return "vnd.android,.cursor.dir/vnd.com.example.databasetest. 
provider .book"; 
case BOOK_ITEM: 
return "vnd.android,.cursor.item/vnd.com.example.databasetest. 
rovider .book"; 
case CATEGORY_DIR: 
return "vnd.android,.cursor.dir/vnd.com.example.databasetest. 
provider .category"; 
case CATEGORY_ITEM: 
return "vnd.android,.cursor.item/vnd.com.example.databasetest. 
provider.category"; 


return null; 


代码 虽然 很 长 ， 不 过 不 用 担心 ， 这 些 内 容 都 非常 容易 理解 ， 因 为 使 用 到 的 
ne a 。 首先 在 类 的 一 开始 ， 同 样 是 定义 了 4 


个 常量 ， 分 别 用 于 表示 访问 Book 表 中 的 所 有 数据 、 访 问 Book 表 中 的 单条 数 
据 、 访 有 数据 和 访问 Category 表 中 的 单条 数据 。 然 后 在 
静态 代码 块 里 对 UriMatcher 进 行 了 初始 化 操作 ， 将 期 望 匹配 的 几 种 URI 格 式 
添加 了 进去 。 


授 下 来 就 是 每 个 抽象 方法 的 具体 实现 了 ， 先 来 看 下 oncreate( ) 方法 ， 这 个 
方法 的 代码 很 短 ， 束 古 创建 了 一 个 MyDatabaseHelper 的 实例 ， 然 后 返回 true 
表示 内 容 提 供 器 初始 化 成 功 ， 这 时 数据 库 束 已 经 完成 了 创建 或 升级 操作 。 


接着 看 一 下 query() 方法 ， 在 这 个 方法 中 移 获 取 到 了 SQLiteDatabase 的 实 

例 ， 然 后 根据 传 入 的 uri 参数 判断 出 用 户 想 要 访问 哪 张 表 ， 再 调用 
SQLiteDatabase 的 query() 进行 查询 ， 并 将 cursor 对 象 返 回 就 好 了 。 注 意 当 
访问 单条 数据 的 时 候 有 一 个 细节 ， 这 里 调用 了 uri 对 象 的 getPathsegments() 
方法 ， 它 会 将 内 容 URI 权 限 之 后 的 部 分 以 “符号 进行 分 割 ， 并 把 分 割 后 的 
结果 放 入 到 一 个 字符 串 列表 中 ， 那 这 个 列表 的 第 0 个 位 置 存放 的 惑 是 路 径 ， 
第 1 个 位 置 存 放 的 就 是 id 了 。 得 到 了 id 之 后 ， 再 通过 selection 和 
selectionArgs 参数 进行 约束 ， 束 实现 了 查询 单条 数据 的 功能 。 


再 往 后 就 是 insert() 方法 ， 同 样 它 也 是 先 获 取 到 了 SQLiteDatabase 的 实例 ， 
然后 根据 传 入 的 uri 参数 判断 出 用 户 想 要 往 哪 张 表 里 添加 数据 ， 再 调用 
SQLiteDatabasehyinsert () 方法 进行 添加 束 可 以 了 。 注 意 insert() 方法 要 求 
返回 一 个 能 够 表示 这 条 新 增 数据 的 URI， 所 以 我 们 还 需要 调用 uri.parse() 
方法 来 将 一 个 内 容 URI 解 析 成 uri 对 象 ， 当 然 这 个 内 容 URI 是 以 新 增 数据 的 
id 结尾 的 。 


接 下 来 就 是 update() 方法 了 ， 相 信 这 个 方法 中 的 代码 已 经 完全 难 不 倒 你 

了 。 也 是 先 获 取 SQLiteDatabase 的 实例 ， 然 后 根据 传 入 的 uri 参数 判断 出 用 
户 想 要 更 狐 哪 张 表 里 的 数据 ， 再 调用 SQLiteDatabase 的 update( ) 方法 进行 更 
狐 束 好 了 ， 受 影响 的 行 数 将 作为 返回 值 返回 。 


下 面 是 delete() 方法 ， 是 不 是 感觉 越 到 后 面 越 轻松 了 ? 因为 你 已 经 渐 入 佳 
境 ， 真 正 地 找到 容 | ] 了。 这 里 仍然 是 先 获 取 到 SQLiteDatabase 的 实例 ， 然 后 
根据 传 入 的 uri 参数 判断 出 用 户 想 要 删除 哪 张 表 里 的 数据 ， 再 调用 
SQLiteDatabase 的 delete() 方法 进行 删除 束 好 了 ， 被 删除 的 行 数 将 作为 返回 
值 返回 。 


最 后 是 getType() 方法 ， 这 个 方法 中 的 代码 完全 是 按照 上 一 节 中 介绍 的 格式 
规则 编写 的 ， 相 信 已 经 没有 什么 解释 的 必要 了 “。 这 样 我 们 融 将 内 容 提供 需 
中 的 代码 全 部 编写 完了 。 


男 外 还 有 一 点 需要 注意 ， 内 容 提 供 器 一 定 要 在 AndroidManifest.xml 文 件 中 六 
册 才 可 以 使 用 。 不 过 浴 运 的 是 ， 由 于 我 们 是 使 用 Android Studio 的 快捷 方式 
创建 的 内 容 提 供 右 ， 因 此 注册 这 一 步 已 经 被 自 动 完 成 了 。 打 开 
AndroidManifest.xml 文 件 瞧 一 瞧 ， 代 码 如 下 所 示 : 


| 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.databasetest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<provider 


android:name=" .DatabaseProvider" 
android:authorities="com.example.databasetest .provider" 
android:enabled="true" 
android:exported="true"> 
</provider> 
</application> 


</manifest> 


可 以 看 到 ，<application> 标签 内 出 现 了 一 个 新 的 标签 <provider> ， 我 们 使 
用 它 来 对 DatabaseProvider 这 个 内 容 提 供 絮 进行 注册 。android:name 属性 指 
定 了 DatabaseProvider 的 类 名 ，android:authorities 属性 指定 了 
DatabaseProvider 的 authority， 而 enabled 和 exported 属性 则 是 根据 我 们 刚才 


勾 选 的 状态 目 动 生 成 的 ， 
行 访 问 。 


现在 DatabaseTest 这 个 项 目 就 已 经 拥有 了 跨 程 序 共 至 数据 的 功能 了 ， 我 们 赶 
快 来 尝试 一 下 。 首 先 需要 将 DatabaseTest 程 序 从 模拟 器 中 删除 掉 ， 以 防止 上 
一 章 中 产生 的 遗留 数据 对 我 们 造成 干扰 。 然 后 运行 一 下 项 目 ， 将 
DatabaseTest 程 序 重新 安装 在 模拟 属 上 了 。 掉 DatabaseTest 这 个 项 
目 ， 并 创建 一 个 新 项 目 ProviderTest， 我 们 就 将 通过 这 个 程序 去 访问 
DatabaseTest 中 的 数据 。 


这 里 表示 允许 DatabaseProvider 被 其 他 应 用 程序 进 


还 是 移 来 编写 下 布局 文件 吧 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 
人 小: 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<Button 


数据 。 


android 
android 
android 


<Button 
android 
android 
android 


<Button 
android 
android 
android 


<Button 
android 
android 
android 


</LinearLayout> 


:id="@+id/add_data" 
:layout_width="match_parent" 
:layout_height="wrap_content" 
android: 


text="Add To Book" /> 


:id="@+id/query_data" 
:layout_width="match_parent" 
:layout_height="wrap_content" 
android: 


text="Query From Book" /> 


:id="@+id/update_data" 
:layout_width="match_parent" 
:layout_height="wrap_content" 
android: 


text="Update Book" /> 


:id="@+id/delete_data" 
:layout_width="match_parent" 
:layout_height="wrap_content" 
android: 


text="Delete From Book" /> 


布局 文件 很 简单 ， 里 面 放 置 了 4 个 按钮 ， 


让 别 用 了 


添加 、 查询 、 修 改 和 删 


private String newId ， 


public class MainActivity extends AppCompatActivity { 


然后 修改 MainActivity 中 的 代码 ， 1 下 所 示 : 


除 


不 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
Button addData = (Button) findViewById(R.id.add data); 
addData.setonclickListener(new View.OnClickListener() { 
Q@override 
public void onClick(View v) { 
// 添加 数据 
Uri uri = Uri.parse("content://com.example.databasetest. provider/ 
book" ); 
ContentValues values = new ContentValues(); 
values.put("name", "A Clash of kKings"); 
values.put("author", "George Martin"); 
values.put("pages", 1040); 
values.put("price", 22.85); 
Uri newUri = getContentResolver().insert(uri, values); 
newId = newUri.getPpathSegments().get(1); 


} 
}); 
Button queryData = (Button) findViewById(R.id.query_data); 
queryData.setonClickListener (new View.OncClickListener() { 
@Override 
public void onClick(View v) { 
// 查询 数据 


Uri uri = Uri.parse("content://com.example.databasetest. provider/ 


book" ); 

Cursor cursor = getContentResolver().query(uri, null, null, null, 
null); 

if (cursor != null) { 


while (cursor.moveToNext()) { 
String name = cursor.getSstring(cursor. getColumnIndex 
("name")); 
String author = cursor.getSstring(cursor. getCcolumnIndex 
("author")); 
int pages = cursor.getIint(cursor.getColumnIndex ("pages")); 
double price = cursor.getDouble(cursor. getColumnIndex 
("price")); 
Log.d("MainActivity", "book name is " + name); 
Log.d("MainActivity", "book author is " + author); 
Log.d("MainActivity", "book pages is " + pages); 
Log.d("MainActivity", "book price is " + price); 
} 


cursor.closel(); 


} 
}); 
Button updateData = (Button) findViewById(R.id.update data); 
updateData.setonClickListener (new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
// 更 新 数据 
Uri uri = Uri.parse("content://com.example.databasetest. provider/ 
book/" + newId); 
ContentValues values = new ContentValues(); 
values.put("name", "A Storm of Swords"); 
values.put("pages", 1216); 
values.put("price", 24.05); 
getcontentResolver().update(uri, values, null, null); 


} 
}); 
Button deleteData = (Button) findViewById(R.id.delete data); 
deleteData.setoncClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 


// 删除 数据 


Uri uri = Uri.parse("content://com.example.databasetest. provider/ 
book/" + newId); 
getContentResolver().delete(uri, null, null); 


可 以 看 到 ， 我 们 分 别 在 这 4 个 按钮 的 点 击 事件 里 面 处 理 了 增删 改 查 的 逻辑 。 


添加 数据 的 时 候 ， 首 先 调 用 了 uri.parse() 方法 将 一 个 内 容 URI 解 析 成 uri 
对 象 ， 然 后 把 要 添加 的 数据 都 存放 到 contentvalues 对 象 中 ， 接 着 调用 
ContentResolver 的 insert() 方法 执行 添加 探 作 就 可 以 了 。 注意 insert() 方 
法 会 返回 一 个 uri 对 象 ， 这 个 对 象 中 包含 了 新 增 数 据 的 id， 我 们 通过 
getPathsegments() 方法 将 这 个 id 取 出 ， 稍 后 会 用 到 它 。 


查询 数据 的 时 候 ， 同 样 是 调用 了 uri.parse() 方法 将 一 个 内 容 URI 解 析 成 uri 
对 象 ， 然 后 调用 contentResolver 的 query() 方法 去 查询 数据 ， 查 询 的 结果 
当然 还 是 存放 在 cursor 对 象 中 的 。 之 后 对 cursor 进行 遍历 ， 从 中 取出 查询 
结果 ， 并 一 一 打印 出 来 。 


更 新 数据 的 时 候 ， 也 是 先 将 内 容 URI 解 析 成 uri 对 象 ， 然 后 把 想 要 更 新 的 数 
据 存放 到 contentVvalues 对 和 象 中 ， 再 调用 contentResolver 的 update() 方法 
执行 更 新 操作 就 可 以 了 。 注 意 这 里 我 们 为 了 不 想 让 Book 表 中 的 其 他 行 受 到 
影响 ， 在 调用 uri.parse() 方法 时 ， 给 内 容 URI 的 尾部 增加 了 一 个 id， 而 这 
个 id 正 是 添加 数据 时 所 返回 的 。 这 束 表 示 我 们 只 希望 更 新 刚刚 添加 的 那 条 数 
据 ，Book 表 中 的 其 他 行 都 不 会 受 影响 。 


删除 数据 的 时 候 ， 也 是 使 用 同样 的 方法 解析 了 一 个 以 id 结尾 的 内 容 URI， 然 
后 调用 contentResolver 的 delete() 方法 执行 删除 操作 束 可 以 了 。 由 于 我 们 
在 内 容 URI 里 指定 了 一 个 id， 因 此 只 会 删 掉 拥 有 相应 id 的 那 行 数据 ，Book 表 
中 的 其 他 数据 都 不 会 受 影响 。 


现在 运行 一 下 ProviderTest 项 目 ， 会 显示 如 图 7.14 所 示 的 界面 。 


i BB 9:40 


ProviderTest 


ADD TO BOOK 


QUERY FROM BOOK 


UPDATE BOOK 


DELETE FROM BOOK 


图 7.14 ProviderTest 主 界面 


点 击 一 下 Add To Book 按 钮 ， 此 时 数据 束 应 该 已 经 添加 到 DatabaseTest 程 序 的 
数据 库 中 了 ， 我 们 可 以 通过 点 击 Query From Book 按 钮 来 检查 一 下 ， 打 印 日 
志 如 图 7.15 所 示 。 


com. example. providertest D/MainActivity: book name is A Clash of Kings 
com. example. providertest D/MainActivity: book author is George Martin 
com. example. providertest D/MainActivity: book pages is 1040 


com. example. providertest D/MainActivity: book price is 22.85 


图 7.15 ”查询 添加 的 数据 


然后 点 击 一 下 Update Book 按 钮 来 更 新 数据 ， 再 点 击 一 下 Query From Book 按 
钮 进行 检查 ， 结 果 如 图 7.16 所 示 。 


Verbose 图 | 


com. example. providertest D/MainActivity: book name is A Storm of Swords 


com. example. providertest D/MainActivity: book author is George Martin 
com. example. providertest D/MainActivity: book pages is 1216 


com. example. providertest D/MainActivity: book price is 24.05 


图 7.16 查询 更 新 后 的 数据 


最 后 点 击 Delete From Book 按 钮 删除 数据 ， 此 时 再 点 击 Query From Book 按 钮 
就 查询 不 到 数据 了 。 由 此 可 以 看 出 ， 我 们 的 路 程序 共享 数据 功能 已 经 成 功 
实现 了 ! 现在 不 仅 是 ProviderTest 程 序 ， 任 何 一 个 程序 都 可 以 轻松 访问 
DatabaseTest 中 的 数据 ， 而 且 我 们 还 丝毫 不 用 担心 隐私 数据 泄漏 的 问题 。 


到 这 里 ， 与 内 容 提 供 右 相关 的 重要 内 容 束 基本 全 部 介绍 完了 ， 下 面 束 让 我 
们 再 次 进入 本 书 的 特殊 环节 ， 学 习 更 多 关于 Git 的 用 法 。 


7.5 ”Git 时 间 一 一 版 本 控制 工具 进 阶 


在 上 一 次 的 Git 时 间 里 ， 我 们 学 习 了 关于 Git 最 基本 的 用 法 ， 包 括 安 装 Git、 创 
建 代码 仓库 ， 以 及 提交 本 地 代码 。 本 市 中 我 们 将 要 学 习 更 多 的 使 用 技巧 ， 
不 过 在 开始 之 前 和 完 要 把 准备 工作 做 好 。 


所 谓 的 谁 备 工 作 就 是 要 给 一 个 项 目 创建 代码 仓库 ， 这 里 就 选择 在 
ProviderTest 项 目 中 创建 吧 ， 打 开 Git Bash， 进 入 到 这 个 项 目的 根 目录 下 面 ， 
然后 执行 git init 命令 ， 如 图 7.17 所 示 。 


$ cd Users Administrator/Androidstudioprojects ProviderTest)/ 


$ git 1n71t 


nitialized empty Git repository in C:/Users/Administrator/AndroidstudioProjects 
ProviderTest/ . g1t 


图 7.17 创建 代码 仓库 
这 样 准备 工作 就 已 经 完成 了 ， 让 我 们 继续 开始 Git 之 旅 吧 。 


7.5.1 忽略 文件 


代码 仓库 现在 已 经 创建 好 了 ， 接 下 来 我 们 应 该 去 提交 ProviderTest 项 目 中 的 
代码 。 不 过 在 提交 之 前 你 也 许 应 该 思考 一 下 ， 是 不 是 所 有 的 文件 都 需要 加 
入 到 版 本 控制 当中 呢 ? 


在 第 1 章 介 绍 Android 项 目 结构 的 时 候 有 提 到 过 ，build 目 录 下 的 文件 都 是 编 
译 项 目 时 目 动 生成 的 ， 我 们 不 应 该 将 这 部 分 文件 添加 到 版 本 控制 当中 ， 那 
么 如 何 才能 实现 这 样 的 效 采 呢 ? 


Git 提 供 了 一 种 可 配 性 很 强 的 机 制 来 多 许 用 户 将 指定 的 文件 或 目录 排除 在 版 
本 控制 之 外 ， 它 会 检查 代码 仓库 的 目录 下 古 否 存在 一 个 名 为 .gitignore 的 文 
件 ， 如 果 存 在 的 话 ， 束 去 一 行 行 读 取 这 个 文件 中 的 内 容 ， 并 把 每 一 行 指定 
的 文件 或 目录 排除 在 版 本 控制 之 外 。 注 意 .gitignore 中 指定 的 文件 或 目录 是 可 
以 使 用 ”通配符 的 。 


神奇 的 是 ， 我 们 并 不 需要 自己 去 创建 .gitignore 文件 ，Android Studio 在 创建 
项 目的 时 候 会 目 动 帮 有 我 们 创建 出 两 个 .gitignore 文件 ， 一 个 在 根 目 录 下 面 ， 
一 个 在 app 模 块 下 面 。 首先 看 一 下 根 目录 下 面 的 .gitignore 文件 ， 如 图 7.18 所 
不 。 


引 .gitignore x 


*. 1ml 

.Fadle 

/local. properties 

1/ .idea/workspace. xml 
/idea/libraries 
.DS_Store 

/build 

/captures 


图 7.18 根 目录 下 面 的 .gitignore 文 件 


这 是 Android Studio 自 动 生成 的 一 些 默 认 配 置 ， 通 常情 况 下 ， 这 部 分 内 容 都 
是 不 用 添加 到 版 本 控制 当中 的 。 我 们 来 简单 阅读 一 下 这 个 文件 ， 除 了 *.iml 
表示 指定 任意 以 .iml 结 尾 的 文件 ， 其 他 都 是 指定 的 具体 的 文件 名 或 者 目录 
名 ， 上 面 配置 中 的 所 有 内 容 都 不 会 被 添加 到 版 本 控制 当中 ， 因 为 基本 都 是 
一 些 由 IDE 目 动 生 成 的 配置 。 


再 来 看 一 人 app 模块 下 面 的 .gitignore 文 件 ， 这 个 驶 简 单 多 了 ， 如 图 7.19 所 
示 “。 


:| app\.gitignore x 


/build Vv 


图 7.19 ” app 模块 下 面 的 .gitignore 文 件 


由 于 app 模 块 下面 基 本 都 是 我 们 编写 的 代码 ， 因 此 默认 情况 下 只 有 其 中 的 
build 目 录 不 会 被 添加 到 版 本 控制 当中 。 


当然 ， 我 们 完全 可 以 对 以 上 两 个 文件 进行 任意 地 修改 ， 来 满足 特定 的 需 
求 。 比 如 说 ，app 模 块 下 面 的 所 有 测试 文件 都 只 是 给 我 目 己 使 用 的 ， 我 并 不 
想 把 它们 添加 到 版 本 控制 中 ， 那 么 吏 可 以 这 样 修改 app/.gitignore 文 件 中 的 内 


/src/androidTest 


没 蚀 ， 只 需 深 加 这 样 两 行 配置 ， 因 为 所 有 的 测试 文件 部 是 放 在 这 这 两 个 目录 
下 的 。 现 在 我 们 可 以 提交 代码 了 ， 先 使 用 add 命令 将 所 有 的 文件 进行 添加 ， 
如 下 所 示 : 


然后 执行 commit 命令 完成 提交 ， 如 下 所 示 : 


git commit -m "First commit." 


7.5.2 ”查看 修改 内 容 


在 进行 了 第 一 次 代码 提交 之 后 ， 我 们 后 面 还 可 能 会 对 项 目 不 断 地 进行 维护 
或 添加 新 功能 等 。 比 较 理想 的 情况 是 每 当 完成 了 一 小 块 功能 ， 就 执行 一 次 
提交 。 但 是 如 果 某 个 功能 牵扯 到 的 代码 比较 多 ， 有 可 能 写 到 后 面 的 时 候 我 
们 就 已 经 忘记 前 面 修 改 了 什么 东西 了 。 遇 到 这 种 情况 时 不 用 担心 ，Git 全 都 
I 
侈 改 的 内 容 。 


查看 文件 修改 情况 的 方法 非常 简单 ， 只 需要 使 用 status 命令 就 可 以 了 ， 在 
项 目的 根 目录 下 输入 如 下 命令 : 


git status 


然后 Git 会 提示 目前 项 目 中 没有 任何 可 提交 的 文件 ， 因 为 我 们 刚刚 才 提 交 过 
嘛 。 现 在 对 ProviderTest 项 目 中 的 代码 稍 做 一 下 改动 ， 修 改 MainActivity 中 的 
代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
QOverride 
protected void onCreate(Bundle savedInstanceState) { 
addData.setonclickListener(new OnClickListener() { 
@Override 
public void oncClick(View v) { 


values.put("price", 55.55); 


} 
}) 


这 里 仅仅 是 在 添加 数据 的 时 候 ， 将 书 的 价格 由 22.85 改 成 了 55.55。 然 后 重新 
输入 git status 命令 ， 这 次 结果 如 图 7.20 所 示 。 


ster 
ot staged for commit: 
git add <file>... ”to update what will be committed) 


<file>...” to discard changes 1n working directory) 


o changes added to commit (use “git add” and/or "git commit -a”) 


图 7.20 查看 文件 变动 情况 


可 以 看 到 ，Git 提 醒 我 们 MainActivity.java 这 个 文件 已 经 发 生 了 更 改 ， 那 么 如 
何 才 能 看 到 更 改 的 内 容 呢 ? 这 职 需 要 借助 diff 命令 了 ， 用 法 如 下 所 示 : 


git diff 


这 样 可 以 查看 到 所 有 文件 的 更 改 内 容 ， 如 果 你 只 想 查 看 MainActivity.java 这 
个 文件 的 更 改 内 容 ， 可 以 使 用 如 下 命令 : 


git diff app/src/main/java/com/example/providertest/MainActivity.java 


命令 的 执行 结 采 如 图 7.21 所 示 。 


EA da 

diff --git a/app/src/main/java/com/example/providertest/MainActivity.JjJava b/app/src/ 
main/jJava/com/example/providertest/MainActivity. java 

index 611ffle. . 3fc46b7 100644 

--- a/app/src/main/jJava/com/example/providertest/MainActivity. -java 


values 


Uri newUri = getContentResolver OO 
newId = newUr1.getPathSegments() .oa 


图 7.21 查看 修改 的 具体 内 容 


其 中 ， 减 号 代表 删除 的 部 分 ， 加 号 代表 添加 的 部 分 。 从 图 中 我 们 就 可 以 明 
显 地 看 出 ， 书 的 价格 由 22.85 被 修改 成 了 55.55。 


7.5.3 ”撤销 未 提交 的 修改 


有 时 候 我 们 的 代码 可 能 会 写 得 过 于 草率 ， 以 至 于 原本 正常 的 功能 ， 结 采 反 
倒 被 我 们 改 出 了 问题 。 遇 到 这 种 情况 时 也 不 用 着 急 ， 因 为 只 要 代码 还 未 提 
交 ， 所 有 修改 的 内 容 都 是 可 以 撤销 的 。 


比如 在 上 一 小 节 中 我 们 修改 了 MainActivity 里 一 本 书 的 价格 ， 现 在 如 果 想 要 
撤销 这 个 修改 就 可 以 使 用 checkout 命令 ， 用 法 如 下 所 示 : 


git checkout app/src/main/java/com/example/providertest/MainActivity.java 


执行 了 这 个 命令 之 后 ， 我 们 对 MainActivityjava 这 个 文件 所 做 的 一 切 修改 就 
应 该 都 被 撤销 了 。 重 新 运行 oit status 命令 检查 一 下 ， 结 果 如 图 7.22 所 示 。 


comnit, working directory clean 


图 7.22 重新 查看 文件 变动 情况 
可 以 看 到 ， 当 前 项 目 中 没有 任何 可 提交 的 文件 ， 说 明 撤销 操作 确实 是 成 功 
了 了 。 


不 过 这 种 撤销 方式 只 适用 于 那些 还 没有 执行 过 add 命令 的 文件 ， 如 采 某 个 文 
TE ， 这 种 方式 就 无 法 撤销 其 更 改 的 内 容 ， 我 们 来 做 个 试验 
瞧 一 瞧 。 


首先 仍然 是 将 MainActivity 中 那 本 书 的 价格 改 成 55.55， 然 后 输入 如 下 命令 : 


i 


这 样 承 把 所 有 修改 的 文件 都 进行 了 添加 ， 可 以 输入 git status 来 检查 一 
下 ， 结 果 如 图 7.23 所 示 。 


." to unstage) 


图 7.23 ”再 次 查看 文件 变动 情况 


现在 我 们 再 执行 一 裔 checkout 命令 ， 你 会 发 现 MainActivity 仍 然 是 处 于 已 添 
加 状态 ， 所 修改 的 内 容 无 法 撤销 掉 。 


这 种 情况 应 该 怎么 办 ? 难道 我 们 还 没 法 后 悔 了 ? 当然 不 是 ， 只 不 过 对 于 已 


添加 的 文件 我 们 应 该 先 对 其 取消 添加 ， 然 后 才 可 以 撤回 提交 。 取 消 添 加 使 
用 的 是 reset 命令 ， 用 法 如 下 所 示 : 


git reset HEAD app/src/main/java/com/example/providertest/MainActivity.java 


然后 再 运行 一 人 裔 git status 命令 ， 你 就 会 发 现 MainActivity.java 这 个 文件 重 
新 变 回 了 未 添加 状态 ， 此 时 就 可 以 使 用 checkout 命令 来 将 修改 的 内 容 进行 
撤销 了 。 


7.5.4 查看 提交 记录 


当 ProviderTest 这 个 项 目 开 发 了 几 个 月 之 后 ， 我 们 可 能 已 经 执行 过 上 百 次 的 
提交 操作 了 ， 这 个 时 候 估 计 你 早 束 已 经 坪 记 每 次 提交 都 修改 了 哪些 内 容 。 
不 过 没关系 ， 忠 实 的 Git 一 直 都 帮 我 们 清 清 楚楚 地 记录 着 呢 ! 可 以 使 用 1og 
命令 查看 历史 提交 信息 ， 用 法 如 下 所 示 : 


由 于 目前 我 们 只 执行 过 一 次 提交 ， 所 以 能 看 到 的 信息 很 少 ， 如 图 7.24 所 示 。 


图 7.24 查看 提交 记录 


可 以 看 到 ， 每 次 提交 记录 都 会 包含 提交 id、 提 交 人 、 提 交 日 期 以 及 提交 摘 述 
这 4 个 信息 。 那 么 我 们 再 次 将 书 价 修改 成 55.55， 然 后 执行 一 次 提交 操作 ， 如 
ThA 


git add . 
git commit -m "Change price." 


现在 重新 执行 git 1og 命令 ,结果 如 图 7.25 所 示 。 


0 onyQgmal - 
Sun kh 1ay 22 19: 21: 49 


Change price. 


OP Tony <tonve 
= mM 》 


图 7.25 重新 查看 提交 记录 


当 提 交 记 录 非 常 多 的 时 候 ， 如 果 我 们 只 想 查 看 其 中 一 条 记录 ， 可 以 在 命令 
中 指定 该 记录 的 id， 并 加 上 -1 参数 表示 我 们 只 想 看 到 一 行 记录 ， 如 下 所 
人 小 : 


git log 1Lfa380b502a00b82bfc8d84c5ab5e15b8fbf7dac -1 


而 如 要 想 妥 查看 这 条 提交 记录 具体 修改 了 什么 内 容 ， 可 以 在 命令 中 加 入 -p 
参数 ， 命 令 如 下 : 


git log 1ifa380b502a00b82bfc8d84c5ab5e1i5b8fbf7dac -1 -p 


查询 出 的 结 采 如 图 7.26 所 示 ， 其 中 减 写 代 表 删 除 的 部 分 ， 加 号 代表 添加 的 部 


得 


b82 pbfc8 8d8455 ab5 el15 ;b8 8Fbf7 da c -1 -p eS 


Change price. 


diff - -git a/app/src/main/V]Jjava/com/examp1e/providertest/MainActivity. java byapp/ysrc/ymain/Java/com 
example,/ /providertest/ MainActivity. Java 
de 611ffle. . 7aa7d21 100644 
--- a/app/src/main/ Java/ ‘Com/ ‘example/ ‘providertest,/ MainActivity. java 
+++ b/app/src/main/]J ex le/ idertest/MainActivity. Java 
ss nity extends pCompatActivity { 
D 


Ur1 newUri = ntentRes lverC insert(uri, values); 
newId = newUr1.getPaths rE 二 I 


图 7.26 查看 提交 记录 的 具体 修改 内 容 


好 了 ， 本 次 的 Git 时 间 束 到 这 里 ， 下 面 我 们 来 对 本 章 中 所 学 的 知识 做 个 回顾 
吧 。 


7.0 小 结 与 点 评 


本 章 的 内 容 不 算 多 ， 而 且 很 多 时 候 都 是 在 使 用 上 一 章 中 学 习 的 数据 库 知 

识 ， 所 以 理解 这 并 0 在 本 章 中 ， 我 们 

一 开始 先 了 解 了 Android 的 权限 机 制 ， 并 且 学 会 了 如 何在 6.0 以 上 的 系统 中 使 

用 运行 时 权限 ， 然 后 又 重点 学 习 了 内 容 提供 磺 的 相关 内 容 ， 以 实现 跨 程 序 

。 有 的 功能。 现在 你 不 仅 知道 了 如 何 去 访 问 其 他 程序 中 的 数据 ， 还 学 
了 怎样 创建 目 己 的 内 容 提 供 器 来 共 至 数据 ， 收 获 还 古 挺 大 的 吧 。 


不 过 每 次 在 创建 内 容 提 供 器 的 上 时候， 你 都 需要 提醒 一 下 自己 ， 我 是 不 是 应 
该 这 么 做 ? 因为 4 有 真正 需要 将 数据 共 党 用 赤 的 时 候 我 们 时 避 该 创 征 容 
仅仅 是 用 于 程序 内 部 访问 的 数据 就 没有 必要 这 么 做 ， 所 以 千 万 别 
它 进行 小 


在 连续 学 了 几 章 系统 机 制 方面 的 内 容 之 后 8 
章 中 我 们 就 来 换 换 口味 ， 学 习 一 下 Android 多 媒体 方面 的 知识 1 


第 8 章 丰富 你 的 程序 一 一 运用 手机 
多 媒体 


在 过 去 ， 手 机 的 功能 都 比较 单调 ， 仅 仅 束 是 用 来 打 电 话 和 发 短信 的 。 而 如 

手机 在 我 们 的 生活 中 正 扮演 着 越 来 越 重要 的 角色 ， 各 种 娱乐 方式 都 可 

羽生 年 机 二 渤 他 : 0 es 外 出 旅行 的 

a 可 以 在 手机 上 看 电影 。 无 论 走 到 哪里 ， 遇 到 喜欢 的 事物 都 可 以 随手 
下 米 


众多 的 娱乐 方式 少不了 强大 的 多 媒体 功能 的 支持 ， 而 Android 在 这 方面 也 做 
得 非常 出 色 。 它 提供 了 一 系列 的 API， 使 得 我 们 可 以 在 程序 中 调用 很 多 手机 
的 多 媒体 资源 ， 从 而 编写 出 更 加 丰富 多 彩 的 应 用 程序 ， 本 章 我 们 就 将 对 
Android 中 一 些 常 用 的 多 媒体 功能 的 使 用 技巧 进行 学 习 。 


前 面 的 7 章 内 容 ， 我 们 一 直 都 是 使 用 模拟 需 来 运行 程序 的 ， 不 过 本 章 涉及 的 
一 些 功能 必须 要 在 真正 的 Android 手 机 上 运行 才 看 得 到 效果 。 因 此 ， 首 先 我 
们 束 来 学 习 一 下 ， 如 何 使 用 Android 手 机 来 运行 程序 。 


8.1 将 程序 运行 到 手机 上 


不 必 我 多 说 ， 首 先 你 需要 拥有 一 部 Android 手 机 。 现 在 Android 手 机 早 就 不 是 
什么 稀罕 物 ， 几 乎 已 经 是 人 手 一 部 了 ， 如 果 你 还 没有 的 话 ， 赶 紧 去 购买 
吧 。 


想 要 将 程序 运行 到 手机 上 ， 我 们 需要 先 通 过 数据 线 把 手机 连接 到 电脑 上 。 
然后 进入 到 设置 -开发 者 选项 界面 ， 并 在 这 个 界面 中 多 选中 USB 调 试 选 
项 ， 如 图 8.1 所 示 。 
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世 开发 者 选项 


开启 


调试 
USB 调 试 
生 接 USB 后 调试 模式 鲁 


撤消 USB 调 试 授权 


错误 报告 快捷 方式 
在 电源 菜单 中 显示 用 于 提交 错误 报告 


选择 模拟 位 置信 息 应 用 
未 设置 模拟 位 置信 息 应 用 


启用 视图 属性 检查 功能 


选择 调试 应 用 


图 8.1 局 用 USB 调 试 


注意 从 Android 4.2 系 统 开 始 ， 开 发 者 选项 默认 是 隐藏 的 ， 你 需要 先进 入 
到 “关于 手机 ”界面 ， 然 后 对 着 最 下 面 的 版 本 号 那 一 栏 连续 点 击 ， 束 会 让 开 
发 者 选项 显示 出 来 。 


然后 如 果 你 使 用 的 是 Windows 操 作 系 统 ， 还 需要 在 电脑 上 安装 手机 的 驱动 。 
一 般 借助 360 手 机 助手 或 吏 豆 芋 等 工具 都 可 以 快速 地 进行 安 疙 ， 安 闭 完 成 后 
就 可 以 看 到 手机 已 经 连接 到 电脑 上 了 ， 如 图 8.2 所 示 。 


手机 定期 体检 你 千古 全 仆人 


了 速度 ， 清 理气 
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图 8.2 手机 成 功 连接 上 电脑 


现在 观察 Android Monitor， 你 会 发 现 当 前 是 有 两 个 设备 在 线 的 ， 一 个 是 我 们 
一 直 使 用 的 模拟 器 ， 男 外 一 个 则 是 刚刚 连接 上 的 手机 了 ， 如 图 8.3 所 示 。 


回 LGE Nexus 5 Android 6.0.1 API 23 v 


下 鄙 Emulator Nexus_5X API 24 Android 7.0, API 24 


三 GE Nexus 5 Android 6.0.1 API 23 


图 8.3 在 线 设备 列表 


然后 运行 一 下 当前 项 目 ， 这 时 不 会 直接 将 程序 运行 到 模拟 器 或 者 手机 上 ， 
而 是 会 弹出 一 个 对 话 框 让 你 进行 选择 ， 如 图 8.4 所 示 。 


孙 
网 Select Deployment Target 


Connected Devices 


图 Nexus 5X API 24 (Android 7.0, API 24) 


LGE Nexus 5 (Androld 6.0.1 API 23 


| Create New Virtual Device Don't see your device? 


[)] Use same selection for future launches 这 2 潮 | Cancel | 


图 8.4 选择 运行 设备 对 话 框 
选中 下 面 的 LGE Nexus 5 后 点 击 OK， 就 会 将 程序 运行 到 手机 上 了 。 


8.2 ”使 用 通知 


通知 (Notification) 是 Android 系 统 中 比较 有 特色 的 一 个 功能 ， 当 某 个 应 用 
程序 布 望 向 用 户 发 出 一 些 提 示 信 息 ， 而 该 应 用 程序 又 不 在 前 台 运 行 时 ， 就 
可 以 借助 通知 来 实现 。 发 出 一 条 通知 后 ， 手 机 最 上 方 的 状态 栏 中 会 显示 一 
个 通知 的 图 标 ， 下 拉 状 态 栏 后 可 以 看 到 通知 的 详细 内 容 。Android 的 通知 功 
0 的 认可 和 喜爱 ， 束 连 iOS 系 统 也 在 5.0 版 本 之 后 加 入 了 类 似 
J 功能 。 


8.2.1 通知 的 基本 用 法 


了 解 了 通知 的 基本 概念 ， 下 面 我 们 束 来 看 一 下 通知 的 使 用 方法 吧 。 通 知 的 
用 法 还 是 比较 灵活 的 ， 既 可 以 在 活动 里 创建 ， 也 可 以 在 广播 接收 侨 里 创 
建 ， 当 然 还 可 以 在 下 一 章 中 我 们 即将 学 习 的 服务 里 创建 。 相 比 于 广播 接收 


絮 和 服务 ， 在 活动 里 创建 通知 的 场景 还 是 比较 少 的 ， 因 为 一 般 只 有 当 程 序 
进入 到 后 台 的 时 候 我 们 才 需 要 使 用 通知 。 


不 过 ， 无 论 是 在 哪里 创建 通知 ， 整 体 的 步 又 都 是 相同 的 ， 下 面 我 们 就 来 学 
习 一 下 创建 通知 的 详细 步骤 。 首 先 需要 一 个 NotificationManager 来 对 通知 进 
行 管 理 ， 可 以 调用 Context 的 getsystemservice() 方法 获取 到 。 
getsystemservice() 方法 接收 一 个 字符 串 参 数 用 于 确定 获取 系统 的 哪个 服 
务 ， 这 里 我 们 传 入 context ,NOTIFICATION_SERVICE 即 可 。 因 此 ， 获 取 
NotificationManager 的 实例 就 可 以 写成 : 


NotificationManager manager = (NotificationManager) 
getSystemService(Context.NOTIFICATION_ SERVICE); 


接 下 来 需要 使 用 一 个 Builder 构 造 器 来 创建 Notification 对 象 ， 但 问题 在 

于 ， 几 乎 Android 系 统 的 每 一 个 版 本 都 会 对 通知 这 部 分 功能 进行 或 多 或 少 的 
修改 ，API 不 稳定 性 问题 在 通知 上 面 突显 得 尤其 严重 。 那 么 该 如 何 解 决 这 个 
问题 氟 ? 其 实 解决 方案 我 们 之 前 已 经 见 过 好 太 回 了 ， 就 是 使 用 support 库 中 
提供 的 兼容 API。support-v4 库 中 提供 了 一 个 NotificationCompat 类 ， 使 用 这 
个 类 的 构造 器 来 创建 Notification 对 象 ， 就 可 以 保证 我 们 的 程序 在 所 有 
Android 系 统 版 本 上 都 能 正常 工作 了 ， 代 码 如 下 所 示 : 


Notification notification = new NotificationCompat.Builder(context).build(); 


当然 ， 上 述 代 码 只 是 创建 了 一 个 空 的 Notification 对 象 ， 并 没有 什么 实际 
作用 ， 我 们 可 以 在 最 终 的 build() 方法 之 前 连 级 任意 多 的 设置 方法 来 创建 一 
个 丰富 的 Notification 对 象 ， 先 来 看 一 些 最 基本 的 设置 : 


Notification notification = new NotificationCompat.Builder(context) 
.SetcontentTitle("This is content title") 
.SetContentText("This is content text") 
.Setwhen(System.currentTimeMillis()) 
.SetSmallIcon(R.drawable.small_ icon) 
.SetLargeIcon(BitmapFactory.decodeResource(getResources(), 

R.drawable.large_icon)) 
.build(); 


上 壕 代 码 中 一 共 调用 了 5 个 设置 方法 ， 下 面 我 们 来 一 一 解析 一 下 。 
setContentTitle() 方法 用 于 指定 通知 的 标题 内 容 ， 下 拉 系 统 状 态 栏 就 可 以 
看 到 这 部 分 内 容 。setcontentText() 方法 用 于 指定 通知 的 正文 内 容 ， 同 样 
下 拉 系 统 状 态 栏 就 可 以 看 到 这 部 分 内 容 。setwhen() 方法 用 于 指定 通知 被 创 
建 的 时 间 ， 以 毫秒 为 单位 ， 当 下 拉 系 统 状态 栏 时 ， 这 里 指定 的 时 间 会 显示 
在 相应 的 通知 上 。 setsmallIcon() 方法 用 于 设置 通知 的 小 图 标 ， 注 意 只 能 
使 用 纯 alpha 图 层 的 图 片 进行 设置 ， 小 图 标 会 显示 在 系统 状态 栏 上。 
setLargeIcon() 方法 用 于 设置 通知 的 大 图 标 ， 当 下 拉 系 统 状 态 栏 时 ， 就 可 
以 看 到 设置 的 大 图 标 了 。 


以 上 工作 都 完成 之 后 ， 只 需要 调用 NotificationManager 的 notify() 方法 就 可 
以 让 通知 显示 出 来 了 。notify() 方法 接收 两 个 参数 ， 第 一 个 参数 是 id ， 要 
保证 为 每 个 通知 所 指定 的 id 都 是 不 同 的 。 第 二 个 参数 则 是 Notification 对 
象 ， 这 里 直接 将 我 们 刚刚 创建 好 的 Notification 对 象 传 入 即 可 。 因 此 ， 显 
示 一 个 通知 就 可 以 写成 : 


manager .notify(1, notification); 


到 这 里 惑 已 经 把 创建 通知 的 每 一 个 步骤 都 分 机 完了， 下 面 吏 让 我 们 通过 一 
个 具体 的 例子 来 看 一 看 通知 到 展 是 长 什么 样 的 。 


新 建 一 个 NotificationTest 项 目 ， 并 修改 activity_main.xml 中 的 代码 ， 如 下 所 
人 小 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/send_notice" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:text="Send notice" /> 


</LinearLayout> 


布局 文件 非常 人 简单， 里面 只 有 一 个 Send notice 按 钮 ， 用 于 发 出 一 条 通知 。 接 
下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


Q@Override 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstancesState); 
setcontentView(R.1layout.activity_main); 
Button sendNotice = (Button) findViewById(R.id,.send notice); 
sendNotice.setOoncClickListener(this); 


} 


Q@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.send_notice: 
NotificationManager manager = (NotificationManager) getSystemService 
(NOTIFICATION_SERVICE) ， 

Notification notification = new NotificationCompat.Builder(this) 
.SetCcontentTitle("This is content title") 
.SetContentText("This is content text") 
.Setwhen(System.currentTimeMillis()) 
.SetSmallIcon(R.mipmap.ic_launcher) 
.SetLargeIcon(BitmapFactory.decodeResource(getResources(), 

R.mipmap.ic_launcher)) 
.build( ); 

manager .notify(1, notification); 

break; 
default: 
break; 


可 以 看 到 ， 我 们 在 Send ee 了 通知 的 创建 工作 ， 
创建 的 过 程 正 如 前 面 所 描述 的 一 样 。 不 过 这 里 人 简单 起 见 ， 我 将 通知 栏 的 大 
小 图 都 直接 设置 成 了 ic _launcher 这 张 图 ， 这 记 样 就 不 用 再 灶 专 | ] 准 备 图 标 了 

而 在 实际 项 目 中 于 万 不 要 这 样 偷懒 。 


现在 可 以 来 运行 一 下 程序 了 ， 点 击 Send notice 按 钮 ， 你 会 在 系统 状态 栏 的 最 
边 看 到 一 个 小 图 标 ， 如 图 8.5 所 示 。 


Ea i 加 7:12 


NotificationTest 


SEND NOTICE 


图 8.5 通知 的 小 图 标 


下 拉 系 统 状 态 栏 可 以 看 到 该 通知 的 详细 信息 ， 如 图 8.6 所 示 。 


This is content title 
his 1s content text 


图 8.6 通知 的 详细 信息 


如 有 果 你 使 用 过 Android 手 机 ， 此 时 应 该 会 下 意识 地 认为 这 条 通知 是 可 以 点 击 
的 。 但 是 当 你 去 点 击 它 的 时 候 ， 你 会 发 现 没 有 任何 效果 。 不 对 啊 ， 好 像 每 
条 通知 点 击 之 后 都 应 该 会 有 反应 的 呀 ? 其 实 要 想 实现 通知 的 点 击 效果 ， 我 
们 还 需要 在 代码 中 进行 相应 的 设置 ， 这 就 涉及 了 一 个 新 的 概念 : 


PendingIntent。 


PendingIntent 从 名 字 上 看 起 来 就 和 Intent 有 些 类 似 ， 它 们 之 间 也 确实 存在 着 
不 少 共同 点 。 比 如 它们 都 可 以 去 指明 某 一 个 “意图 ”， 都 可 以 用 于 启动 活 

动 、 局 动 服务 以 及 发 送 广播 等 。 不 同 的 是 ，Intent 更 加 倾向 于 去 立即 执行 某 
个 动作 ， 而 PendingIntent 更 加 倾 癌 于 在 某 个 合适 的 时 机 去 执行 某 个 动作 。 所 
以 ， 也 可 以 把 PendingIntent 简 单 地 理解 为 延迟 执行 的 ntent 。 


PendingIntent 的 用 法 同样 很 简单 ， 它 主要 提供 了 几 个 静态 方法 用 于 获取 
PendingIntent 的 实例 ， 可 以 根据 需求 来 选择 是 使 用 getActivity() 方法 、 
getBroadcast() 方法 ， 还 是 getservice() 方法 。 这 几 个 方法 所 接收 的 参数 
都 是 相同 的 ， 第 一 个 参数 依旧 是 context ， 不 用 多 做 解释 。 第 二 个 参数 一 般 
用 不 到 ， 通 常 都 是 传 入 0 即 可 。 第 三 个 参数 是 一 个 Intent 对 象 ， 我 们 可 以 通 
过 这 个 对 象 构 建 出 PendingIntent 的 “意图 ”。 第 四 个 参数 用 于 确定 
PendingIntent 的 行为 ， 有 FLAG_ONE_SHOT 、FLAG_NO_CREATE 、 
FLAG_CANCEL_CURRENT 和 FLAG_UPDATE_CURRENT 这 4 种 值 可 选 ， 每 种 值 的 具体 
舍 义 你 可 以 查看 文档 ， 通 常情 况 下 这 个 参数 传 入 0 就 可 以 了 。 


对 PendingImtent 有 了 一 定 的 了 解 后 ， 我 们 再 回 过 头 来 看 一 下 
NotificationCompat.Builder ° 这 个 构 造 右 还 可 以 再 连 组 一 个 
setcontentIntent() 方法 ， 接 收 的 参数 正 是 一 人 1 Pond no Otont 对 象 。 
la 可 以 通过 PendingIntent 构 建 出 一 个 延迟 执行 的 “意图 ”， 当 用 户 点 
击 这 条 通知 时 整 会 执行 相应 的 逻辑 。 


现在 我 们 来 优化 一 下 NotificationTest 项 目 ， 给 刚才 的 通知 加 上 点 击 功 能 ， 让 
用 户 点 击 它 的 时 候 可 以 启动 男 一 个 活动 。 


首先 需要 准备 好 另 一 个 活动 ， 右 击 com.example.notificationtest 包 
~New 一 Activity Empty Activity， 新 建 NotificationActivity， 布 局 起 名 为 
notification_layout。 然后 修改 notification_layout.xml 中 的 代码 ， 如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_centerInpParent="true" 
android:textSize="24sp" 
android:text="This is notification layout" 
/> 


</RelativeLayout> 


这 样 就 把 NotificationActivity 这 个 活动 准备 好 了 ， 下 面 我 们 修改 MainActivity 
中 的 代码 ， 给 通知 加 入 点 击 功 能 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


QOverride 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.send_notice: 

Intent intent = new Intent(this, NotificationActivity.class); 

PendingIntent pi = PendingIntent.getActivity(this, 0, intent, 0); 

NotificationManager manager = (NotificationManager) getSystemService 

(NOTIFICATION_SERVICE) ， 

Notification notification = new NotificationCompat.Builder(this) 
.SetCcontentTitle("This is content title") 
.SetContentText("This is content text") 
.Setwhen(System.currentTimeMillis()) 
.SetSmallIcon(R.mipmap.ic_launcher) 
.SetLargeIcon(BitmapFactory.decodeResource(getResources(), 

R.mipmap.ic_launcher)) 


.SetContentIntent(pI) 
.build(); 
manager .notify(1, notification); 
break; 
default: 
break; 


可 以 看 到 ， 这 里 先是 使 用 Intent 表 达 出 我 们 想 要 启动 NotificationActivity 的 “ 意 
图 ”"， 然 后 将 构建 好 的 Intent 对 象 传 入 到 PendingIntent 的 getActivity() 方法 
里 ， 以 得 到 PendingIntent 的 实例 ， 接 着 在 Notificationcompat .Builder 中 调 

用 setcontentIntent() 方法 ， 把 它 作 为 参数 传 入 即 可 。 


现在 重新 运行 一 下 程序 ， 并 点 击 Send notice 按 钮 ， 依 旧 会 发 出 一 条 通知 。 然 
后 下 拉 系 统 状态 柱 ， 点 击 一 下 该 通知 ， 束 会 看 到 NotificationActivity 这 个 活 
动 的 界面 了 ， 如 图 8.7 所 示 。 


NotificationTest 


This is notification layout 


图 8.7 点击 通 知 后 打开 NotificationActivity 界 面 


号? 怎么 系统 状态 上 的 通知 图 标 还 没有 消失 呢 ? 是 这 样 的 ， 如 果 我 们 没有 
在 代码 中 对 该 通知 进行 取消 ， 它 就 会 一 直 显 示 在 系统 的 状态 位 上 。 解 决 的 
方法 有 两 种 ， 一 种 是 在 NotificationCompat . Builder 中 再 连 组 一 个 
setAutocancel() 方法 ， 一 种 是 显 式 地 调用 NotificationManager 的 cancel() 
方法 将 它 取 消 ， 两 种 方法 我 们 都 学 习 一 下 。 


第 一 种 方法 写法 如 下 : 


Notification notification = new NotificationCompat .Builder(this) 


.SetAutoCancel(true) 


.build(); 


可 以 看 到 ，setAutocancel() 方法 传 入 true ， 就 表示 当 点 击 了 这 个 通知 的 时 
候 ， 通 知 会 自动 取消 掉 。 


第 二 种 方法 写法 如 下 : 


public class NotificationActivity extends AppCompatActivity { 


QOverride 
protected void onCreate(Bundle savedIinstanceState) { 
super.onCreate(savedIinstanceState); 
SetContentView(R. Layout,notification_ layout ) ， 
NotificationManager manager = (NotificationManager) getSystemService 
(NOTIFICATION_ SERVICE); 
manager .cancel(1); 


这 里 我 们 在 cancel() 方法 中 传 入 了 1， 这 个 1 是 什么 意思 呢 ? 还 记得 在 创建 
通知 的 时 候 给 每 条 通知 指定 的 id 吗 ? 当时 我 们 给 这 条 通知 设置 的 id 殉 是 1。 
因此 ， 如 果 你 想 取消 哪 条 通知 ， 在 cancel( ) 方法 中 传 入 该 通知 的 id 就 行 了 。 


8.2.2 ”通知 的 进 阶 技巧 


现在 你 已 经 掌握 了 创建 和 取消 通知 的 方法 ， 并 且 知 道 了 如 何 去 啊 应 通知 的 
扩 击 事件 。 不 过 通知 的 用 法 并 不 仅仅 古 这 些 呢 ， 下 面 我 们 束 来 探究 一 下 通 
知 的 更 多 技巧 。 


上 一 小 节 中 创建 的 通知 属于 最 基本 的 通知 ， 实 际 上 ， 

Notificationcompat .Builder 中 提供 了 非常 丰富 的 API 来 让 我 们 创建 出 更 加 
多 样 的 通知 效果 。 当 然 ， 每 一 个 API 都 详细 地 讲 一 所 不 太 可 能 ， 我 们 只 能 从 
中 选 一 些 比 较 常 用 的 API 来 进行 学 习 。 先 来 看 看 setsound() 方法 吧 ， 它 可 以 
在 通知 发 出 的 时 候 播 放 一 段 音频， 这 样 就 能 够 更 好 地 告知 用 户 有 通知 到 
来 。setsound() 方法 接收 一 个 uri 参数 ， 所 以 在 指定 音频 文件 的 时 候 还 需要 
先 获取 到 首 频 文件 对 应 的 URI。 比 如 说 ， 每 个 手机 

的 /system/media/audio/ringtones 目 录 下 都 有 很 多 的 首 频 文件 ， 我 们 可 以 从 中 
随便 选 一 个 首 频 文件 ， 那 么 在 代码 中 就 可 以 这 样 指 定 : 


Notification notification = new NotificationCompat.Builder(this) 


.SetSound(Uri.fromFile(new File("/system/media/audio/ringtones/Luna.ogg"))) 
.build(); 


除了 人 允许 播放 音频 外 ， 我 们 还 可 以 在 通知 到 来 的 时 候 让 手机 进行 振动 ， 使 
用 的 是 vibrate 这 个 属性 。 它 是 一 个 长 整 型 的 数组 ， 用 于 设置 手机 静止 和 振 
动 的 时 长 ， 以 晕 秒 为 单位 。 下 标 为 0 的 值 表 示 手 机 静止 的 时 长 ， 下 标 为 1 的 
值 表示 手机 振动 的 时 长 ， 下 标 为 2 的 值 又 表示 手机 静止 的 时 长 ， 以 此 类 推 。 
所 以 ， 如 果 想 要 让 手机 在 通知 到 来 的 时 候 立 刻 振动 1 秒 ， 然 后 静止 1 秒 ， 青 
振动 1 秒 ， 代 码 束 可 以 写成 : 


Notification notification = new NotificationCompat.Builder(this) 


.SetVibrate(new long[] {0, 1000, 1000, 1000 }) 
.build(); 


不 过 ， 想 要 控制 手机 振动 还 需要 声明 权限 。 因 此 ， 我 们 还 得 编辑 
AndroidManifest.xml 文 件 ， 加 入 如 下 声明 : 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.notificationtest" 
android:versionCode="1" 
android:versionName="1.0" > 


<uses-permission android:name="android.permission.VIBRATE" /> 


</manifest> 


学 会 了 控制 通知 的 声音 和 振动 ， 下 面 我 们 来 看 一 下 如 何在 通知 到 来 时 控制 
手机 LED 灯 的 显示 。 


现在 的 手机 基本 上 都 会 前 置 一 个 LED 灯 ， 当 有 未 接 电话 或 未 读 短 信 ， 而 此 
时 手机 又 处 于 锁 屏 状态 时 ，LED 灯 就 会 不 停 地 闪烁 ， 提 醒 用 户 去 查看 。 我 
们 可 以 使 用 setLights() 方法 来 实现 这 种 效 末 ，setLights() 方法 接收 3 个 参 
数 ， 第 一 个 参数 用 于 指定 LED 灯 的 颜色 ， 第 二 个 参数 用 于 指定 LED 灯 腕 起 
的 时 长 ， 以 营 秒 为 单位 ， 第 三 个 参数 用 于 指定 LED 灯 暗 去 的 时 长 ， 也 是 以 
量 秒 为 单位 。 所 以 ， 当 通知 到 来 时 ， 如 有 果 想 要 实现 LED 灯 以 绿色 的 灯光 一 
内 一 内 的 效果 ， 束 可 以 写成 : 


Notification notification = new NotificationCompat.Builder(this) 


.SetLights(Color.GREEN, 1000, 1000) 
.build(); 


当然 ， 如 果 你 不 想 进 行 那 么 多 繁杂 的 设置 ， 也 可 以 直接 使 用 通知 的 默认 效 
它 会 根据 当前 手机 的 环境 来 决定 播放 什么 铃声 ， 以 及 如 何 振 动 ， 写 法 
0 下 : 


Notification notification = new NotificationCompat.Builder(this) 


.SetDefaults(NotificationCompat .DEFAULT_ALL) 
.build(); 


主意 ， 以 上 所 涉及 的 这 些 进 阶 技巧 都 要 在 手机 上 运行 才能 看 得 到 效果 ， 模 
所 器 是 无 法 表现 出 振动 以 及 LED 灯 闪烁 等 功能 的 。 


8.2.3 ”通知 的 高 级 功能 


继续 观察 Notificationcompat .Builder 这 个 类 ， 你 会 发 现 里 面 还 有 很 多 API 
是 我 们 没有 使 用 过 的 。 那 么 下 面 我 们 就 来 学 习 一 些 更 加 强大 的 API 的 用 法 ， 
从 而 构建 出 更 加 丰富 的 通知 效果 。 


先 来 看 看 setstyle() 方法 ， 这 个 方法 允许 我 们 构建 出 语文 本 的 通知 内 容 。 
也 就 是 说 通知 中 不 光 可 以 有 文字 和 图 标 ， 还 可 以 包公 更 多 的 东西 。 
setstyle() 方法 接收 一 个 Notificationcompat .Style 参数 ， 这 个 参数 束 是 用 


来 构建 具体 的 语文 本 信息 的 ， 如 长 文字 、 图 片 等 。 


在 开始 使 用 setstyle() 方法 之 前 ， 我 们 先 来 做 一 个 试验 吧 ， 之 前 的 通知 内 
容 部 比较 短 ， 如 琳 设 置 成 很 长 的 文字 会 是 什么 效果 呢 ? 比 如 这 样 写 : 


Notification notification = new NotificationCompat.Builder(this) 


rm 
F t 
中 


.SetContentText("Learn how to build notifications, send and sync data, and use 
voice actions. Get the official Android IDE and developer tools to build 
apps for Android.") 


.build()， 


现在 重新 运行 程序 并 触发 通知 ， 效 琳 如 图 8.8 所 示 。 


This is content title 5-36 AM 
Learn how to bulld notifications, send and sync dat 


图 8.8 通知 内 容 文字 过 长 的 效果 

可 以 看 到 ， 通 知 内 容 是 无 法 显示 完整 的 ， 多 余 的 部 分 会 用 省 略 号 来 代替 。 
其 实 这 也 很 正常 ， 因 为 通知 的 内 容 本 来 就 应 该 言 简 意 凡 ， 详 细 内 容 放 到 点 
击 后 打开 的 活动 当中 会 更 加 合适 。 

但 是 如 果 你 真 的 非常 需要 在 通知 当中 显示 一 段 长 文字 ，Android 也 是 支持 

的 ， 通 过 setstyle() 方法 束 可 以 做 到 ， 具 体 写 法 如 下 : 


Notification notification = new NotificationCompat.Builder(this) 


.SetStyle(new NotificationCompat.BigTextStyle().bigText("Learn how to build 
notifications, send and Sync data, and use voice actions. Get the official 
Android IDE and developer tools to build apps for Android.")) 


‘build( ); 


我 们 在 setstyle() 方法 中 创建 了 一 个 NotificationCompat .BigTextStyle 对 
象 ， 这 个 对 象 就 是 用 于 封闭 长 文字 信息 的 ， 我 们 调用 它 的 bigText() 方法 并 
将 文字 内 容 传 入 束 可 以 了 。 


再 次 重新 运行 程序 并 触发 通知 ， 效 果 如 图 8.9 所 示 。 


Da 6-19 AM 

Learn how to build notificatio ns, send and syr 
data, and use voice actions. Get the offic cial Ai ndr Did 
IDE and developer tools to bu vilc 1 apps for Android 


图 8.9 通知 中 显示 长 文字 的 效果 


除了 显示 长 文字 之 外 ， 通 知 里 还 可 以 显示 一 张大 图 片 ， 具 体 用 法 也 是 基本 
相似 的 : 


Notification notification = new NotificationCompat .Builder(this) 


.SetSstyle(new NotificationCompat.BigPictureStyle().bigPicture 
(BitmapFactory.decodeResource(getResources(), R.drawable.big_image))) 


‘build( ); 


可 以 看 到 ， 这 里 仍然 是 调用 的 setstyle() 方法 ， 这 次 我 们 在 参数 中 创建 了 
一 个 Notificationcompat .Bigpicturestyle 对 象 ， 这 个 对 象 就 是 用 于 设置 大 
图 片 的 ， 然 后 调用 它 的 bigpPicture() 方法 并 将 图 片 传 入 。 这 里 我 事先 准备 
好 了 一 张 图 片 ， 通 过 BitmapFactory 的 decodeResource() 方法 将 图 片 解 析 成 
Bitmap 对 和 象 ， 再 传 入 到 pbigpicture() 方法 中 就 可 以 了 。 


现在 重新 运行 一 下 程序 并 触发 通知 ， 效 果 如 图 8.10 所 示 。 


图 8.10 通知 中 显示 大 图 片 的 效果 
这 样 我 们 就 把 setstyle() 方法 中 的 重要 内 容 基 本 都 掌握 了 


接 下 来 再 学 习 一 下 setpriority() 方法 ， 它 可 以 用 于 设置 通知 的 重要 程度 。 
setPriority() 方法 接收 一 个 整 型 参数 用 于 设置 这 条 通知 的 重要 程度 ， 一 共 
有 5 个 常量 值 可 选 : PRIORITY_DEFAULT 表示 默认 的 重要 程度 ， 和 不 设置 效果 

是 一 样 的 ;，PRIORITY_MIN 表示 最 低 的 重要 程度 ， 系 统 可 能 只 会 在 特定 的 场 


景 才 显示 这 条 通知 ， 比 如 用 户 下 拉 状 态 栏 的 时 候 ; PRIORITY_Low 表示 较 低 
的 重要 程度 ， 系 统 可 能 会 将 这 类 通知 缩小 ， 或 改变 其 显示 的 顺序 ， 将 其 排 
在 更 重要 的 通知 之 后 ; PRIORITY_HIGH 表示 较 高 的 重要 程度 ， 系 统 可 能 会 将 
这 类 通知 放大 ， 或 改变 其 显示 的 顺序 ， 将 其 排 在 比较 靠 前 的 位 置 ; 
PRIORITY_MAX 表示 最 高 的 重要 程度 ， 这 类 通知 消息 必须 要 让 用 户 立 刻 看 
到 ， 甚 至 需要 用 户 做 出 啊 应 操作 。 具 体 写法 如 下 : 


Notification notification = new NotificationCompat.Builder(this) 


.SetPriority(NotificationCompat .PRIORITY_MAX) 


.build(); 


这 里 我 们 将 通知 的 重要 程度 设置 成 了 最 高 ， 表 示 这 是 一 条 非常 重要 的 通 
知 ， 要 求 用 户 必须 立刻 看 到 。 现 在 重新 运行 一 下 程序 ， 并 点 击 Send notice 按 
钮 ， 效 有 果 如 图 8.11 所 示 。 


讨 This is content title 
his content x 


图 8.11 触发 一 条 重要 通知 


可 以 看 到 ， 这 次 的 通知 不 是 在 系统 状态 栏 显示 一 个 小 图 标 了 ， 而 是 弹出 了 
一 个 横幅 ， 并 附带 了 通知 的 详细 内 容 ， 表 示 这 是 一 条 非常 重要 的 通知 。 不 
管用 户 现在 是 在 玩 游戏 还 是 看 电影 ， 这 条 通知 都 会 显示 在 最 上 方 ， 以 此 引 
起 用 户 的 注意 。 当 然 ， 使 用 这 类 通知 时 一 定 要 小 心 ， 确 保 你 的 通知 内 容 的 
确 是 至 关 重 要 的 ， 不 然 如 果 让 用 户 产 生 反感 的 话 ， 很 可 能 会 导致 我 们 的 应 
用 程序 被 番 载 。 


8.3 ”调用 摄像 头 和 相册 


我 们 平时 在 使 用 QQ 或 微 信 的 时 候 经 和 常 要 和 别人 分 享 图 片 ， 这 些 图 片 可 以 是 
用 手机 摄像 头 拍 的 ， 也 可 以 是 从 相册 中 选取 的 。 类 似 这 样 的 功能 实在 是 太 
常见 了 ， 几 乎 在 每 一 个 应 用 程序 中 都 会 §， 那 么 本 市 我 们 束 学 习 一 下 调用 
摄像 头 和 相册 方面 的 知识 。 


8.3.1 ”调用 摄像 头 拍 照 


先 来 看 看 摄像 头 方面 的 知识 ， 现 在 很 多 的 应 用 都 会 要 求 用 户 上 传 一 张 图 片 
来 作为 头像 ， 这 时 打开 摄像 尖 担 张 照 古 最 简单 快捷 的 。 下 面 就 让 我 们 通过 
个 例子 来 学 习 一 下 ， 如 何 才 能 在 应 用 程序 里 调用 手机 的 摄像 头 进行 拍 

We 


新 建 一 个 CameraAlbumTest 项 目 ， 然 后 修改 activity_main.xml 中 的 代码 ， 如 下 
所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 


android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<Button 
android:id="@+id/take_photo" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Take Photo" /> 


<ImageView 
android:id="@+id/picture" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" /> 


</LinearLayout> 


| | 


可 以 看 到 ， 布 局 文件 中 只 有 两 个 控件 ， 一 个 Button 和 一 个 ImageView 。 
Button 是 用 于 打开 摄像 头 进 行 折 照 的 ， 而 ImageView 则 是 用 于 将 招 到 的 图 片 
显示 出 来 。 


然后 开始 编写 调用 摄像 头 的 具体 逻辑 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 


人 小 : 


public class MainActivity extends AppCompatActivity { 


public static final int TAKE_PHOTO = 1; 
private ImageView picture; 
private Uri imageUrI， 


Q@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedIinstanceState); 
setcontentView(R.1layout.activity_main); 
Button takePhoto = (Button) findViewById(R.id.take_ photo); 
picture = (ImageView) findViewById(R.id.picture); 
takePhoto.setonClickListener(new View.OnClickListener() { 
Q@override 
public void onclick(View v) { 
// 创建 File 对 象 ， 用 于 存储 拍照 后 的 图 片 
File outputImage = new File(getExternalcacheDir(), 
"output_image.jpg"); 
try { 
if (outputImage.exists()) { 
outputImage.delete( ); 


outputImage.createNewFile( ); 
} catch (IOException e) { 
e.printSstackTrace( ); 


} 
if (Build.VERSION.SDK_INT >= 24) { 
imageUri = FileProvider.getUriForFile(MainActivity.this, 
"com.example.cameraalbumtest.fileprovider", outputIimage); 
} else { 
imageUri = Uri.fromFile(outputImage); 
} 


// 启动 相机 程序 

Intent intent = new Intent("android.media.action.IMAGE CAPTURE"); 
intent.putExtra(MediaStore.EXTRA_OUTPUT, imageUri); 
startActivityForResult(intent, TAKE_PHOTO); 


了 
} 


QOverride 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
switch (requestCode) { 
case TAKE_PHOTO: 
if (resultCode == RESULT_OK) { 
try { 
// 将 拍摄 的 照片 显示 出 来 
Bitmap bitmap = BitmapFactory.decodeStream(getContent - 


Resolver().openInputStream(imageUri)); 
picture.setIimageBitmap(bitmap); 
} catch (FileNotFoundException e) { 
e,printStackTrace( ); 


上 述 代 码 稍微 有 点 复杂 ， 我 们 来 仔细 地 分 析 一 下 。 在 MainActivity 中 要 做 的 
第 一 件 事 目 然 是 分 别 获取 到 Button 和 ImageView 的 实例 ， 并 给 Button 注 册 上 
点 击 事件 ， 然 后 在 Button 的 点 击 事件 里 开始 处 理 调用 摄像 头 的 逻辑 ， 我 们 重 
点 看 一 下 这 部 分 代码 。 


首先 这 里 创建 了 一 个 File 对 象 ， 用 于 存放 摄像 头 拍 下 的 图 乒 ， 这 里 我 们 把 
图 片 命名 为 output_image.jpg， 并 将 它 存放 在 手机 SD 卡 的 应 用 关联 缓存 目录 
下 。 什 么 叫 作 应 用 关联 缓存 目录 呢 ? 就 是 指 SD 卡 中 专门 用 于 存放 当前 应 用 
缓存 数据 的 位 置 ， 调用 getExternalcacheDir( ) 方法 可 以 得 到 这 个 目录 ， 具 
体 的 路 径 是 /sdcard/Android/data/<package name>/cache。 那 么 为 什么 要 使 用 

应 用 关联 缓 目 孙 来 存放 图 片 呢 ? 因为 从 Android 6.0 系 统 开 始 ， 读 写 SD 卡 被 

列 为 了 和 危险 权限 ， 如 果 将 图 片 存放 在 SD 卡 的 任何 其 他 目录 ， 都 要 进行 运行 
时 权限 处 理 才 行 ， 而 使 用 应 用 关联 目录 则 可 以 跳 过 这 一 步 。 


接着 会 进行 一 个 判断 ， 如 采 运 行 设备 的 系统 版 本 低 于 Android 7.0， 束 调用 
Uri 的 fromFile() 方法 将 File 对 象 转换 成 uri 对象 ， 这 个 Uri 对 象 标 识 着 
output_image.jpg 这 张 图 片 的 本 地 真实 路 径 。 否 则 ， 就 调用 FileProvider 的 
getUriForFile() 方法 将 File 对 象 转换 成 一 个 封装 过 的 uri 对 象 。 
getuUriForFile() 方法 接收 3 个 参数 ， 第 一 个 参数 要 求 传 入 context 对 象 ， 第 
二 个 参数 可 以 是 任意 唯一 的 字符 串 ， 第 三 个 参数 则 是 我 们 刚刚 创建 的 File 
对 象 。 之 所 以 要 进行 这 样 一 层 转换 ， 是 因为 从 Android 7.0 系 统 开始 ， 直 接 使 
用 本 地 真实 路 径 的 Uri 被 认为 是 不 安全 的 ， 会 抛 出 一 个 
FileUriExposedException 异 常 。 而 FileProvider 则 是 一 种 特殊 的 内 容 提 供需 ， 
它 使 用 了 和 内 容 提 供 器 类 似 的 机 制 来 对 数据 进行 保护 ， 可 以 选择 性 地 将 二 
装 过 的 Uri 共 享 给 外 部 ， 从 而 提高 了 应 用 的 安全 性 。 


接 下 来 构建 出 了 一 个 Intent 对 象 ， 并 将 这 个 Intent 的 action 指定 为 


android.media.action.IMAGE_CAPTURE ， 再 调用 Intent 的 putExtra( ) 方法 指 


定 图 厂 的 输出 地 址 ， 这 里 填 入 刚刚 得 到 的 Uri 对 象 ， 最 后 调用 
startActivityForResult() 来 启动 活动 。 由 于 我 们 使 用 的 是 一 个 隐 式 
Intent， 系 统 会 找 出 能 够 响应 这 个 Intent 的 活动 去 启动 ， 这 样 照 相机 程序 就 会 
被 打开 ， 拍 下 的 照片 将 会 输出 到 output_image.jpg 中 。 


生意， 刚才 我 们 是 使 用 startActivityForResult() 来 启动 活动 的 ， 因 此 拍 完 
照 后 会 有 结果 返回 到 onActivityResult() 方法 中 。 如 有 果 发 现 哲 照 成 功 ， 就 

可 以 调用 BitmapFactory 的 decodestream( ) 方法 将 output_image.jpg 这 张 照片 

解析 成 Bitmap 对 象 ， 然 后 把 它 设置 到 ImageView 中 显示 出 来 。 


不 过 现在 还 没 结 束 ， 刚才 提 到 了 内 容 提 供 屁 那么 我 们 目 然 要 在 
AndroidManifest.xml 中 对 内 容 提供 器 进行 汶 ee 如 下 所 示 : 


下 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 

package="com.example.cameraalbumtest"> 

<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<provider 
android:name="android.support.v4.content.FileProvider" 
android:authorities="com.example.cameraalbumtest.fileprovider" 
android:exported="false" 
android:grantUriPermissions="true"> 
<meta-data 
android:name="android.support.FILE PROVIDER_PATHS" 
android:resource="@xml/file_paths" /> 
</provider> 
</application> 
</manifest> 


其 中 ， android:name 属性 的 值 是 固定 的 ， android:authorities 属性 的 值 必 
须要 和 刚才 Fileprovider .getUriForFile() 方法 中 的 第 二 个 参数 一 致 。 另 
2 这 里 还 在 <provider> 标签 的 内 部 使 用 <meta-data> 来 指定 uri 的 共享 路 

并 引用 了 一 个 @xm1/file_paths 资产。 当然 ， 这 个 资源 现在 还 是 不 存在 
下 面 我 们 就 来 创建 它 。 


右 击 res 目录 一 New 一 Directory， 创建 一 个 xml 目 录 ， 接 着 右 击 xml 目 录 
一 New 一 File， 创 建 一 个 仙 e_paths.xml 文 件 。 然 后 修改 和 仙 e_paths.xml 文 件 中 
的 内 容 ， 如 下 所 示 : 


<?xml1 version="1.0" encoding="utf-8"?> 
<paths xmlns:android="http://schemas.android.com/apk/res/android"> 


<external-path name="my_images" path="" /> 
</paths> 


其 中 ，external-path 就 是 用 来 指定 uri 共享 的 ，name 属性 的 值 可 以 随便 


填 ，path 属性 的 值 表示 共享 的 具体 路 径 。 这 里 设置 空 值 就 表示 将 整个 SD 卡 
进行 共享 ， 当 然 你 也 可 以 仅 共 享 我 们 存放 output_image.jpg 这 张 图 片 的 路 


径 。 


另外 还 有 一 点 要 注意 ， 在 Android 4.4 系 统 之 前 ， 访 问 SD 卡 的 应 用 关联 目录 
也 是 要 声 明 入 限 的 从 4. 4 系统 开始 不 再 需要 权限 声明 。 那 么 我 们 为 了 能 够 
兼容 老 版 本 系统 的 手机 ， 还 需要 在 AndroidManifest.xml 中 声明 一 下 访问 SD 
卡 的 权限 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.cameraalbumtest"> 
<uses-permission android:name="android.permission.WRITE EXTERNAL_STORAGE" /> 


</manifest> 


这 样 代码 就 都 编写 完了 ， 现 在 将 程序 运行 到 手机 上 ， 然 后 后 击 Take Photo 按 
钮 就 可 以 进行 拍照 了 ， 如 图 8.12 所 示 。 拍 照 完成 后 ， 点 击 中 间 按 钮 就 会 回 到 
我 们 程序 的 界面 。 同 时 ， 拍 摄 的 照片 也 会 显示 出 来 了 ， 如 图 8.13 所 示 。 


图 8.12 打开 摄像 头 拍照 


Me ey 
CameraAlbumTest 


TAKE PHOTO 


图 8.13 ”拍照 的 最 终 效 果 


8.3.2 ”从 相册 中 选择 照片 


虽然 调用 摄像 头 拍照 既 方 便 又 快捷 ， 但 我 们 并 不 是 每 次 都 需要 去 当场 担 一 
张 照片 的 。 因 为 每 个 人 的 手机 相册 里 应 该 都 会 在 有 许 许多 多 张 照 上 请， 直接 
从 相册 里 选取 一 张 现 有 的 照片 会 比 打开 相机 拍 一 张 照片 更 加 第 用 。 一 个 优 
秀 的 应 用 程序 应 该 将 这 两 种 选择 方式 都 提供 给 用 户 ， 由 用 户 来 决定 使 用 哪 
一 种 。 下 面 我 们 融 来 看 一 下 ， 如 何 才能 实现 从 相册 中 选择 照片 的 功能 。 


还 是 在 CameraAlbumTest 项 目的 基础 上 进行 修改 ， 编 辑 activity_main.xml 文 
件 ， 在 布局 中 添加 一 个 按钮 用 于 从 相册 中 选择 照片 ， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<Button 
android:id="@+id/take_photo" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Take Photo" /> 


<Button 
android:id="@+id/choose_from album" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Choose From Album" /> 


<ImageView 
android:id="@+id/picture" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center_horizontal" /> 


</LinearLayout> 


然后 修改 MainActivity 中 的 代码 ， 加 入 从 相册 选择 照片 的 逻辑 ， 代 码 如 下 所 


public class MainActivity extends AppCompatActivity { 


public static final int CHOOSE_PHOTO = 2; 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
Button takePhoto = (Button) findViewById(R.id.take photo); 
Button chooseFromAlbum = (Button) findViewById(R.id.choose from album); 


chooseFromAlbum.setOonClickListener(new View.OnClickListener() { 
Q@Override 
public void oncClick(View v) { 
If (ContextCompat.checkSelfpermission(MainActivity.this, 
Manifest.permission.WRITE_ EXTERNAL_ STORAGE) != PackageManager. 
PERMISSION_GRANTED) { 
ActivityCompat.requestPermissions(MainActivity.this, new 
String[]{ Manifest.permission. WRITE_EXTERNAL_STORAGE }, 1); 
} else { 
openAlbum( ); 


private void openAlbum() { 
Intent intent = new Intent("android.intent.action.GET_CONTENT"); 
intent.setType("image/*"); 
startActivityForResult(intent, CHOOSE_PHOT0O); // 打开 相册 


} 


QOverride 
public void onRequestPermissionsResult(int requestCode, String[] permissions, 


int[] grantResults) { 
switch (requestCode) { 


case 1: 
If (grantResults. length > 0 && grantResults[0] == PackageManager. 


PERMISSION_GRANTED) { 
openAlbum( ) ， 


} else { 
Toast.makeText(this, "You denied the permission", 


Toast ,LENGTH_SHORT) ,show( ); 


} 
break; 
default: 
} 
} 
QOverride 


protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
switch (requestCode) { 


case CHOOSE_PHOTO: 
if (resultCode == RESULT_OK) { 

// 判断 手机 系统 版 本 号 

if (Build.VERSION.SDK_INT >= 19) { 
// 4.4 及 以 上 系统 使 用 这 个 方法 处 理 图 片 
handleImageOonKitkat (data); 

} else { 
// 4.4 以 下 系统 使 用 这 个 方法 处 理 图 片 
handleImageBeforeKitkat(data); 


} 
} 
break; 
default: 
break; 
} 
} 
Q@TargetApi(19) 


private void handleImageOnKitKat(Intent data) { 
String imagePath = null; 
Uri uri = data.getDatal( ); 
if Documentseontract’ isDocumentUri(this, uri)) { 
// 如 果 是 document 类 型 的 Uri， 则 通过 document id 处 理 
String docId = DocumentsContract.getDocumentId(uri); 
if("com.android.providers.media.documents".equals(uri.getAuthority())) { 
String id = docId.split(":")[1]; // 解析 出 数字 格式 的 id 
String selection = MediaStore.Images.Media._ID + "=" + id,; 
imagePath = getImagePath(MediaStore.Images.Media.EXTERNAL_ 
CONTENT_URI, selection); 
} else if ("com.android.providers.downloads.documents".equals(uri. 
getAuthority())) { 
Uri contentUri = ContentUris.withAppendedId(Uri.parse("content: 
//downloads/public_downloads"), Long.valueof(docId)); 
imagePath = getImagePath(contentUri, null); 


} else if ("content",.equalsIgnoreCase(uri.getscheme())) { 
// 如 果 是 content 类 型 的 Uri， 则 使 用 普通 方式 处 理 
imagePath = getImagePath(uri, null]l); 

} else if ("file". equalsIgnoreCase(uri, getscheme())) { 
// 如 果 是 file 类 型 的 Uri， 直 接 获 取 图 片 路 径 即 可 
imagePath = uri.getPpath(); 


亚 


displayImage(imagePath); // 根据 图 片 路 径 显示 医 


} 


private void handleImageBeforeKitkat(Intent data) { 
Uri uri = data.getDatal( ) ， 
String imagePath = getImagePath(uri, null); 
displayImage(imagePath); 


private String getImagePath(Uri uri, String selection) { 

String path = null; 
// 通过 Uri 和 selection 来 获取 真实 的 图 片 路 径 
Cursor cursor = getContentResolver().query(uri, null, selection, null, null); 
if (cursor != nul1) { 

if (cursor.moveToFirst()) { 

path = cursor,getString(cursor .getCcolumnIndex(MediaStore， 
Images.Media.DATA)); 


} 
cursor.close( ); 
} 


return path,; 


} 


private void displayImage(String imagePath) { 
if (imagePath != nul1) { 
Bitmap bitmap = BitmapFactory.decodeFile(imagePath); 
picture.setImageBitmap(bitmap); 
} else { 
Toast.makeText(this, "failed to get image", Toast.LENGTH_SHORT).show(); 


可 以 看 到 ， 在 Choose From Album 按 钮 的 点 击 事 件 里 我 们 先是 进行 了 一 个 运 
行 时 权限 处 理 ， 动 态 申请 wRITE_EXTERNAL_STORAGE 这 个 危险 权限 。 0 
要 申请 这 个 权限 呢 ? 因为 相册 中 的 照片 都 是 存储 在 SD 卡 上 的 ， 我 们 要 从 SD 


卡 中 读 取 照片 就 需要 申请 这 个 权限 。 WRITE_EXTERNAL_STORAGE 表示 同时 授予 
程序 对 SD 卡 读 和 写 的 能 


当 用 户 授 权 了 权限 申请 之 后 会 调用 openAlbum( ) 方法 ， 这 里 我 们 先是 构建 出 
了 一 个 Intent 对 象 ， 并 将 它 的 action 指定 为 
android.intent.action.6GET_CONTENT 。 接 着 给 这 个 Intent 对 象 设置 一 些 必 
要 的 参数 ， 然 后 调用 startActivityForResult() 方法 就 可 以 打开 相册 程序 选 
择 上 照片 了 。 注意 在 调用 startActivityForResult() 方法 的 时 候 ， 我 们 给 第 二 
个 参数 传 入 的 值 变 成 了 cHoosE_pPHoTo ， 这 样 当 从 相册 选择 完 图 片 回 到 
onActivityResult() 方法 时 ， 就 会 进入 cHoosE_PHoT0 的 case 来 处 理 图 片 。 
接 下 来 的 逻辑 就 比较 复杂 了 ， 自 完 为 了 兼容 新 老 版 本 的 手机 ， 我 们 做 了 一 
个 判 炳 ， 如 归 是 4.4 及 以 上 系统 的 手机 就 调用 handleImageonKitkat() 方法 来 
处 理 图 片 ， 否 则 就 调用 nandleImageBeforeKitkat() 方法 来 处 理 图 片 。 之 所 


以 要 这 样 做 ， 是 因为 Android 系 统 从 4.4 版 本 开始 ， 选 取 相 册 中 的 图 片 不 再 返 
回 图 片 真 实 的 Uri 了 ， 而 是 一 个 封 狠 过 的 Uri， 因 此 如 末 是 4.4 版 本 以 上 的 3 
机 就 需要 对 这 个 Uri 进 行 解析 才 行 。 


那么 handleImageonkitkat () 方法 中 的 逻辑 就 基本 是 如 何 解 析 这 个 封 狼 过 的 
Uri 了 。 这 里 有 好 几 种 判断 情况 ， 如 果 返 回 的 Uri 是 document 类 型 的 话 ， 那 就 
取出 document id 进行 处 理 ， 如 果 不 是 的 话 ， 那 区 使 用 普通 的 方式 处 理 。 兄 
外 ， 如 果 Uri 的 authority 是 media 格 式 的 话 ，document id 还 需要 再 进行 一 次 
解析 ， 要 通过 字符 串 分 割 的 方式 取出 后 半 部 分 才能 得 到 真正 的 数字 id。 取 出 
的 id 用 于 构建 新 的 Uri 和 条 件 语句， 然后 把 这 些 值 作为 参数 传 入 到 
getImagePath() 方法 当中 ， 残 可 以 获取 到 图 片 的 真实 路 径 了 。 拿 到 图 片 的 
路 径 之 后 ， 再 调用 displayImage() 方法 将 图 片 显 示 到 界面 上 。 


tm 


相 比 于 handleImageonKitkat() 方法 ， handleImageBeforeKitkat() 方法 中 的 
逻辑 就 要 简单 得 多 了 ， 因 为 它 的 Uri 是 没有 封装 过 的 ， 不 需要 任何 解析 ， 直 
接 将 Uri 传 入 到 getImagePath( ) 方法 当中 就 能 获取 到 图 片 的 真实 路 径 了 ， 最 
后 同样 是 调用 displayImage( ) 方法 来 让 图 片 显示 到 界面 上 。 


现在 将 程序 重新 运行 到 手机 上 ， 然 后 点 击 一 下 Choose From Album 按 钮 ， 首 
完 会 弹出 权限 申请 框 ， 如 图 8.14 所 示 。 


py 


| 要 人 允许 


CameraAlbumTest’ 方 I9] 
您 设备 上 的 照片 、 媒 体 
内 容 和 文件 吗 ? 


拒绝 


图 8.14 申请 访问 SD 卡 权 限 
点 击 允 许 之 后 就 会 打开 手机 相册 ， 如 图 8.15 所 示 。 


FP Wk 


图 8.15 打开 手机 相册 


然后 随意 选择 一 张 照 ; 们 程序 的 界面 ，; a 
然后 随意 先 泽 一 张 照片 ， 回 到 我 们 程序 的 界面 ， 选 中 的 照片 应 六 就 会 显示 


> ka 
CameraAlbumTest 


TAKE PHOTO 


CHOOSE FROM ALBUM 


图 8.16 选择 照片 的 最 终 效果 


调用 摄像 头 担 照 以 及 从 相册 中 选择 照片 是 很 多 Android 应 用 都 会 市 有 的 功 
能 ， 现 在 你 已 经 将 这 两 种 技术 都 学 会 了 ， 将 来 在 工作 中 如 果 需 要 开发 类 似 
的 功能 ， 相 信 你 一 定 能 轻松 完成 的 。 不 过 目前 我 们 的 实现 还 不 算 完 美 ， 因 
为 某 些 照片 即使 经 过 裁剪 后 体积 仍然 很 天， 直接 加 载 到 内 存 中 有 可 能 会 导 
致 程序 朋 溃 。 更 好 的 做 法 是 根据 项 目的 需求 先 对 照片 进行 适当 的 压缩 ， 然 
后 再 加 载 到 内 存 中 。 人 至 于 如 何 对 照片 进行 压缩 ， 束 要 考验 你 查阅 资料 的 能 
力 了 ， 这 里 束 不 再 展开 进行 讲解 了 。 


8.4 ”播放 多 媒体 文件 


手机 上 最 常见 的 休闲 方式 襄 无 疑问 驶 是 听 音 乐 和 看 电影 了 ， 随 着 移动 设备 
的 普及 ， 越 来 越 多 的 人 都 可 以 随时 享受 优美 的 音乐 ， 以 及 观看 精彩 的 电 
影 。 而 Android 在 播放 首 频 和 视频 方面 也 是 做 了 相当 不 错 的 支持 ， 它 提供 了 
一 套 较 为 完整 的 API， 使 得 开发 者 可 以 很 轻松 地 编写 出 一 个 简易 的 音频 或 视 
频 播放 器 ， 下 面 我 们 束 来 具体 地 学 习 一 下 。 


8.4.1 ”播放 音频 


在 Android 中 播放 音频 文件 一 般 都 是 使 用 Mediaplayer 类 来 实现 的 ， 它 对 多 种 
格式 的 音频 文件 提供 了 非常 全 面 的 控制 方法 ， 从 而 使 得 播放 音乐 的 工作 变 
得 十 分 简单 。 下 表 列 出 了 Mediaplayer 类 中 一 些 较为 常用 的 控制 方法 。 


有 
设置 要 播放 的 音频 文件 的 位 置 
始 播放 之 前 调用 这 个 方法 完成 准备 
F 始 或 继续 播放 音频 


1 i 二 象 重 置 到 刚刚 创建 的 状态 


E 位置 开始 播放 音频 


放 音频 。 调 用 这 个 方法 后 的 MediaPlayer 对 象 无 法 再 


release() 释放 掉 与 MediaPlayer 对 象 相关 的 资源 


获取 载 入 的 音频 文件 的 四 


简单 了 解 了 上 壕 方 法 后 ， 我 们 再 来 梳理 一 下 MediapPlayer 的 工作 流程 。 上 首先 
需要 创建 出 一 个 MediaPlayer 对 象 ， 然 后 调用 setpDatasource( ) 方法 来 设置 
音频 文件 的 路 径 ， 再 调用 prepare() 方法 使 ediaPlayer 进入 到 准备 状态 ， 
接 下 来 调用 start() 方法 吏 可 以 开始 播放 音频 ， 调 用 pause() 方法 号 会 暂停 
播放 ， 调 用 reset() 方法 就 会 停止 播放 。 


下 面 就 让 我 们 通过 一 个 具体 的 例子 来 学 习 一 下 吧 ， 新 建 一 个 PlayAudioTest 
项 目 ， 然 后 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<Button 
android:id="@+id/play" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Play" /> 


<Button 
android:id="@+id/pause" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Pause" /> 


<Button 
android:id="@+id/stop" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Stop" /> 


</LinearLayout> 


布局 文件 中 放置 了 3 个 按钮 ， 分 别 用 于 对 音频 文件 进行 播放 、 暂 停 和 停止 操 
作 。 然 后 i 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener{ 


private MediaPlayer mediaPlayer = new Mediaplayer(); 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
Button play = (Button) findViewById(R.id.play); 
Button pause = (Button) findViewById(R.id.pause); 
Button stop = (Button) findViewById(R.id.stop); 
play.setonCclickListener(this); 
pause.setOoncClickListener(this); 
stop.setonClickListener(this); 
if (ContextCompat.checkSelfPpermission(MainActivity.this, Manifest. permission. 

WRITE_EXTERNAL_STORAGE) != PackageManager .PERMISSION_ GRANTED) { 


ActivityCompat.requestPermissions(MainActivity.this, new String[]{ 
Manifest.permission. WRITE EXTERNAL_STORAGE }, 1); 
} else { 
initMediaPlayer(); // 初始 化 MediaPlayer 


} 
} 
private void initMediaPlayer() { 
try { 
File file = new File(Environment.getExternalStorageDirectory(), 
"music.mp3"); 
mediapPlayer .setDataSsource(file.getPath()); // 指定 音频 文件 的 路 径 
mediaPlayer.prepare(); // 让 MediaPlayer 进 入 到 准备 状态 
} catch (Exception e) { 
e,printStackTrace( ); 
} 
} 
QOverride 


public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 
case 1: 
If (grantResults. length > 0 && grantResults[0] == PackageManager. 
PERMISSION_GRANTED) { 
initMediapPlayer(); 
} else { 
Toast .makeText(this, "拒绝 权限 将 无 法 使 用 程序 "， 
Toast .LENGTH_SHORT) .show( ); 


finish(); 
} 
break; 
default: 
} 
} 
Q@Override 


public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.play: 
if (!'mediaplayer.isPplaying()) { 
mediaPlayer.start(); // 开始 播放 


} 
break; 
case R.id.pause: 
if (mediaPplayer.isplaying()) { 
mediaPlayer .pause(); // 暂停 播放 


} 


break; 
case R.id.stop: 
if (mediapPlayer.isplaying()) { 
mediaPlayer.reset(); // 停止 播放 
initMediaplayer(); 


} 
break; 
default: 
break; 
} 
} 
@Override 


protected void onDestroy() { 
super.onDestroy(); 
if (mediaPlayer != null) { 
mediaPlayer .stop(); 


mediaPlayer.release(); 


可 以 看 到 ， 在 类 初始 化 的 时 候 我 们 束 先 创建 了 一 个 MediaPlayer 的 实例 ， 然 


后 在 oncreate( ) 方法 中 进行 了 运行 时 权限 处 理 ， 动 态 申请 
WRITE_EXTERNAL_STORAGE 权限 。 这 是 由 于 答 会 我 们 会 在 SD 卡 中 放置 一 个 音 
频 文 件 ， 程 序 为 了 播放 这 个 音频 文件 必须 拥有 访问 SD 卡 的 权限 才 行 。 注 
意 ， 在 onRequestPermissionsResult() 方法 中 ， 如 果 用 户 拒 绝 了 权限 申请 ， 

那么 区 调用 finish() 方法 将 程序 直接 关 挥 ， 因 为 如 有 果 没 有 SD 卡 的 访问 权 
限 ， 我 们 这 个 程序 将 什么 都 干 不 了 。 


用 户 同意 授权 之 后 就 会 调用 initMediaplayer() 方法 为 Mediaplayer 对 象 进 

行 初始 化 操作 。 在 initMediaPlayer() 方法 中 ， 首 先是 通过 创建 一 个 File 对 
象 来 指定 音频 文件 的 路 径 ， 从 这 里 可 以 看 出 ， 我 们 需要 事先 在 SD 卡 的 根 目 

录 下 放置 一 个 名 为 music. mp3 的 音频 文件 。 后 面 依次 调用 了 setDataSource() 
方法 和 prepare() 方法 ， 为 MediaPlayer 做 好 了 播放 前 的 准备 。 


接 下 来 我 们 看 一 下 各 个 按钮 的 点 击 事件 中 的 代码 。 当 点 击 Play 按钮 时 会 进行 
判断 ， 如 有 果 当 前 MediaPlayer 没 有 正在 播放 音频 ， 则 调用 start() 方法 开始 播 
放 。 当 点 击 Pause 按 钮 时 会 判断 ， 如 果 当 前 MediaPlayer 正 在 播放 首 频 ， 则 调 
用 pause( ) 方法 暂停 播放 。 当 点 击 Stop 按 钮 时 会 判断 ， 如 果 当 前 MediaPlayer 
正在 播放 音频 ， 则 调用 reset () 方法 将 MediaPlayer 重 置 为 刚刚 创建 的 状态 ， 
然后 重新 调用 一 人 裔 initMediapPlayer() 方法 。 


最 后 在 onDestroy() 方法 中 ， 我 们 还 需要 分 别 调用 stop() 方法 和 release() 
方法 ， 将 与 MediaPlayer 相 关 的 资源 释放 掉 。 


2 站 ， 千 万 不 要 忘记 在 AndroidManifest.xml 文 件 中 声明 用 到 的 权限 ， 如 下 所 
人 小: 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.playaudiotest"> 
<uses-permission android:name="android.permission.WRITE EXTERNAL_STORAGE" /> 


</manifest> 


这 样 一 个 简易 版 的 音乐 播放 器 就 完成 了 ， 现 在 将 程序 运行 到 手机 上 会 先 弹 
出 权限 申请 框 ， 如 图 8.17 所 示 。 


A 四 23:03 


[| 要 人 允许 PlayAudioTest 访 
问 您 设备 上 的 照片 、 媒 
体内 容 和 文件 吗 ? 


拒绝 


图 8.17 音乐 播放 器 主 界面 


同意 授权 之 后 就 可 以 开始 播放 音乐 了 ， 点 击 一 下 Play 按钮 ， 优 美的 音乐 就 会 
啊 起 ， 然 后 点 击 Pause 按 钮 ， 音 乐 就 会 停 住 ， 再 次 点 击 Play 按钮 ， 会 接着 暂 
停 之 前 的 位 置 继续 播放 。 这 时 如 果 点 击 一 下 Stop 按 钮 ， 首 乐 也 会 停 住 ,但 是 
当 再 次 点击 Play 按 钮 和 时， 首 乐 束 会 从 头 开始 播放 了 。 


8.4.2 ”播放 视频 


播放 视频 文件 其 实 并 不 比 播放 音频 文件 复杂 ， 主 要 是 使 用 VideoView 类 来 实 
现 的 。 这 个 类 将 视频 的 显示 和 控制 集 于 一 身 ， 使 得 我 们 仅仅 借助 它 束 可 以 
完成 一 个 人 简易 的 视频 播放 絮 。VideoView 的 用 法 和 MediaPlayer 也 比较 类 似 ， 
主要 有 以 下 常用 方法 : 


功能 描述 


setVideoPath() 


pause() 


seekTo() 
isplaying() 


getDuration() 


dn 
然后 修改 activity__ 


<LinearLayout xmlns 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<LinearLayout 


设置 要 播放 的 视频 文件 的 位 置 


台 或 继续 播放 视频 


暂停 播放 视频 


FE 在 播放 视频 


获取 载 入 的 视频 文件 的 时 长 


一 个 实际 的 例子 来 学 习 一 下 吧 ， 新 建 PlayVideoTest 项 目 ， 
main.xml 中 的 代码 ， 如 下 所 示 : 


:android="http://schemas.android.com/apk/res/android" 


android:layout_width="match_parent" 
android:layout_height="wrap_content" > 


<Button 
android 
android 
android 
android 
android 


<Button 
android 


:id="@+id/play" 
:layout_width="Qdp" 
:layout_height="wrap_content" 
:layout_ weight="1" 
:text="Play" /> 


:id="@+id/pause" 


android:layout_width="QOdp" 
android:layout_height="wrap_content" 
android:layout_ weight="1" 
android:text="Pause" /> 


<Button 
android:id="@+id/replay" 
android:layout_width="QOdp" 
android:layout_height="wrap_content" 
android:layout_ weight="1" 
android:text="Replay" /> 


</LinearLayout> 

<VideoView 
android:id="@+id/video_view" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" /> 


</LinearLayout> 


在 这 个 布局 文件 中 ， 首 先 放置 了 3 个 按钮 ， 分 别 用 于 控制 视频 的 播放 、 和 暂停 
和 重新 播放 。 ee 稍 后 的 视频 就 将 在 


这 里 显示 。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener{ 


private VideoView videoView; 


Q@Override 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
videoView = (VideoView) findViewById(R.id.video view); 
Button play = (Button) findViewById(R.id.play); 
Button pause = (Button) findViewById(R.id.pause); 
Button replay = (Button) findViewById(R.id.replay); 
play.setonCclickListener(this); 
pause.setOoncClickListener(this); 
replay.setoncCclickListener(this); 
if (ContextCompat.checkSelfPpermission(MainActivity.this, Manifest. 
permission.WRITE EXTERNAL_STORAGE) != PackageManager .PERMISSION GRANTED) { 
ActivityCompat.requestPermissions(MainActivity.this, new String[]{ 
Manifest.permission. WRITE_EXTERNAL_STORAGE }, 1); 
} else { 
initVideoPath(); // 初始 化 VideoView 
= 
} 


private void initVideoPath() { 
File file = new File(Environment.getExternalStorageDirectory(), "movie.mp4"); 
videoView.setVideoPath(file.getPath()); // 指定 视频 文件 的 路 径 


} 


QOverride 
public void onRequestPermissionsResult(int requestCode, String[] permissions, 


int[] grantResults) { 
switch (requestCode) { 
case 1: 
if (grantResults.length > 0 && grantResults[0] == PackageManager. 
PERMISSION_GRANTED) { 
initVideopPath(); 
} else { 
Toast .makeText(this, " 拒 
show( ); 
finish(); 


A 


色 权 限 将 无 法 使 用 程序 "，Toast .LENGTH_SHORT). 


} 
break; 
default: 


} 


QOverride 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.play: 
if (!videoView,.isPlaying()) { 
videoView.start(); // 开始 播放 


break; 
case R.id.pause: 
if (videoView.isPplaying()) { 
videoView.pause(); // 暂停 播放 
} 
break; 
case R.id.replay: 
if (videoView.isPplaying()) { 
videoView.resume(); // 重新 播放 


| 


} 
break; 
} 
} 


Q@Override 
protected void onDestroy() { 
super .onDestroy(); 
if (videoView != null) { 
videoView.suspend!(); 


这 部 分 代码 相信 你 理解 起 来 会 很 轻松 ， 因 为 它 和 前 面 播 放 音 频 的 代码 非常 
类 似 。 首 先 在 oncreate() 方法 中 同样 进行 了 一 个 运行 时 权限 处 理 ， 因 为 视 
频 文 件 将 会 放 在 SD 卡 上 。 当 用 户 同 意 授权 了 之 后 就 会 调用 initvideoPath( ) 
方法 来 设置 视频 文件 的 路 径 ， 这 里 我 们 需要 事先 在 SD 卡 的 根 目 录 下 放置 一 
个 名 为 movie.mp4 的 视频 文件 。 


下 面 看 一 下 各 个 按钮 的 点 击 事件 中 的 代码 。 当 点 击 Play 按 钮 时 会 进行 判断 ， 
如 采 当 前 并 没有 正在 播放 视频 ， 则 调用 start() 方法 开始 播放 。 当 点 击 


Pause 按 钮 时 会 判断 ， 如 采 当 前 视频 正在 播放 ， 则 调用 pause( ) 方法 暂停 播 
放 。 当 点 击 Replay 按 钮 时 会 判断 ， 如 采 当 前 视频 正在 播放 ， 则 调用 resume() 
方法 从 头 播 放 视 频 。 


最 后 在 onpestroy() 方法 中 ， 我 们 还 需要 调用 一 下 suspend() 方法 ， 将 
VideoView 所 占用 的 资源 释放 挤 。 


另外 ， 仍 然 始 终 要 记得 在 AndroidManifest.xml 文 件 中 声明 用 到 的 权限 ， 如 下 
所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.playvideotest"> 
<uses-permission android:name="android.permission.WRITE_ EXTERNAL_STORAGE" /> 


</manifest> 


现在 将 程序 运行 到 手机 上 ， 会 先 弹出 一 个 权限 申请 对 话 框 ， 同 意 授 权 之 后 
扩 击 一 下 Play 按 钮 ， 就 可 以 看 到 视频 已 经 开始 播放 了 ， 如 图 8.18 所 示 。 


PlayVideoTest 


PLAY PAUSE REPLAY 


图 8.18 ”VideoView 播 放 视 频 的 效果 
点 击 Pause 按 钮 可 以 暂停 视频 的 播放 ， 点 击 Replay 按 钮 可 以 从 头 播放 视频 。 


这 样 的 话 ， 你 就 已 经 将 VideoView 的 基本 用 法 掌握 得 差不多 了 。 不 过 ， 为 什 
么 它 的 用 法 和 MediaPlayer 这 么 相似 呢 ? 其 实 VideoView 只 是 帮 我 们 做 了 一 个 
很 好 的 封装 而 已 ， 它 的 背后 仍然 是 使 用 MediaPlayer 来 对 视频 文件 进行 控制 
的 。 另 外 需要 注意 ，VideoView 并 不 是 一 个 万 能 的 视频 播放 工具 类 ， 它 在 视 
频 格式 的 文 持 以 及 播放 效率 方面 都 存在 着 较 大 的 不 足 。 所 以 ， 如 果 想 要 仅 
仅 使 用 VideoView 束 编写 出 一 个 功能 非常 强大 的 视频 播放 恬 是 不 太 现 实 的 。 
但 是 如 果 只 是 用 于 播放 一 些 游戏 的 片头 动画 ， 或 者 某 个 应 用 的 视频 宣传 ， 
使 用 VideoView 还 是 绰 综 有 余 的 。 


好 了 ， 关 于 Android 多 媒体 方面 的 知识 你 已 经 学 得 足够 多 了 ， 下 面 束 让 我 们 
起 来 总 结 一 下 本 章 所 学 的 内 容 吧 。 


8.5 ”小 结 与 点 评 


本 章 我 们 主要 对 Android 系 统 中 的 各 种 多 媒体 技术 进行 了 学 习 ， 其 中 包括 通 
知 的 使 用 技巧 、 调 用 摄像 头 拍照 、 从 相册 中 选取 照片 ， 以 及 播放 音频 和 视 
频 文件 。 由 于 所 涉及 的 多 媒体 技术 在 模拟 器 上 很 难看 得 到 效果 ， 因 此 本 章 
中 还 特意 讲解 了 在 Android 手 机 上 调试 程序 的 方法 。 


又 是 充实 饱满 的 一 章 啊 ! 现在 多 媒体 方面 的 知识 已 经 学 得 足够 多 了 ， 我 希 
望 你 可 以 很 好 地 将 它们 消化 挥 ， 尤 其 是 与 通知 相关 的 内 容 ， 因 为 后 面 的 学 
习 当 中 还 会 用 到 它 。 目 前 我 们 所 学 的 所 有 东西 都 仅仅 是 在 本 地 上 进行 的 ， 
而 实际 上 几乎 市 场 上 的 每 个 应 用 都 会 涉及 网 络 交互 的 部 分 ， 所 以 下 一 章 中 
我 们 将 会 学 习 一 下 Android 网 络 编程 方面 的 内 容 。 


第 9 章 看 看 精彩 的 世界 一 一 使 用 网 
络 技术 


如 采 你 在 玩 手 机 的 时 候 不 能 上 网 ， 那 你 一 定 会 感到 特别 地 梧 燥 乏味 。 没 
错 ， 现 在 早已 不 是 玩 单 机 的 时 代 了 ， 无 论 是 PC、 手 机 、 平 板 ， 还 是 电视 ， 
几乎 都 会 具备 上 网 的 功能 ， 在 可 预见 的 未 来 ， 手 表 、 有 眼镜 、 汽 车 等 设备 也 
会 逐个 加 入 到 这 个 行列 ，21 世 纪 的 确 是 互联 网 的 时 代 。 


当然 ，Android 手 机 肯定 也 是 可 以 上 网 的 ， 所 以 作为 开发 者 ， 我 们 就 需要 考 
虑 如 何 利用 网 络 来 编写 出 更 加 出 色 的 应 用 程序 ， 像 QQ、 微 博 、 微 信 等 常见 
的 应 用 都 会 大 量 使 用 网 络 技术 。 本 章 主要 会 讲述 如 何在 手机 端 使 用 HTTP 协 
议和 服务 句 端 进行 网 络 交 互 ， 并 对 服务 右 返 回 的 数据 进行 解析 ， 这 也 是 
Android 中 最 党 使 用 到 的 网 络 技 术 ， 下 面 束 让 我 们 一 起 来 学 习 一 下 吧 。 


9.1 WebView 的 用 法 


有 时 候 我 们 可 能 会 磁 到 一 些 比较 特殊 的 需求 ， 比 如 说 要 求 在 应 用 程序 里 展 
示 一 些 网 页 。 相 信 每 个 人 都 知道 ， 加 载 和 显示 网 页 通常 都 是 浏览 硕 的 任 
务 ， 但 是 需求 里 又 明确 指出 ， 不 允许 打开 系统 浏览 器 ， 而 我 们 当然 也 不 可 
能 目 己 去 编写 一 个 浏 贤 右 出 来 ， 这 时 应 该 垮 么 办 呢 ? 


不 用 担心 ，Android 早 就 已 经 考虑 到 了 这 种 需求 ， 并 提供 了 一 个 WebView 控 
件 ， 借 助 它 我 们 束 可 以 在 目 己 的 应 用 程序 里 典 入 一 个 浏览 需 ， 从 而 非常 轻 
松 地 展示 各 种 各 样 的 网 页 。 


WebView 的 用 法 也 是 相当 简单， 下 面 我 们 就 通过 一 个 例子 来 学 习 一 下 吧 。 
新 建 一 个 WebViewTest 项 目 ， 然 后 修改 activity_main.xml 中 的 代码 ， 如 下 所 
人 小: 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<WebView 
android:id="@+id/web_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" /> 


</LinearLayout> 


可 以 看 到 ， 我 们 在 布局 文件 中 使 用 到 了 一 个 新 的 控件 ，WebView。 这 个 控 
件 当然 也 就 十 用 来 显示 网 页 的 了 ， 这 里 的 写法 很 位 单 ， 给 它 设置 了 一 个 id， 
并 让 它 充 满 整 个 屏 问 。 


然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
Super .oncCreate(SavedInstanceState ) 
SetContentView(R. Layout,activity_main) ， 
WebView webView = (WebView) findVvViewById(R.id.web_view) ， 
webView.getSettings().setJavascriptEnabled(true); 
webView.setwebViewClient(new WebViewClient()); 


webView.loadUrl("http://www.baidu.com"); 


MainActivity 中 的 代码 也 很 短 ， 首先 使 用 findviewById() 方法 获取 到 了 
WebView 的 实例 ， 然 后 调用 WebView 的 getsettings() 方法 可 以 去 设置 一 些 
浏览 器 的 属性 ， 这 里 我 们 并 不 去 设置 过 多 的 属性 ， 只 是 调用 了 
setJavascriptEnabled() 方法 来 让 WebView 支 持 JavaScript 肢 本 。 


接 下 来 是 非常 重要 的 一 个 部 分 ， 我 们 调用 了 WebView 的 setwebviewCclient() 
方法 ， 并 传 入 了 一 个 WebViewClient 的 实例 。 这 段 代 码 的 作用 是 ， 当 需要 从 
一 个 网 页 跳 转 到 男 一 个 网 页 时 ， 我 们 希望 目标 网 页 仍然 在 当前 WebView 中 

显示 ， 而 不 是 打开 系统 浏览 器 。 


最 后 一 步 就 非常 简单 了 ， 调 用 WebView 的 loadurl() 方法 ， 并 将 网 址 传 入 ， 
即 可 展示 相应 网 页 的 内 容 ， 这 里 就 让 我 们 看 一 看 百度 的 首页 长 什么 样 吧 。 


另外 还 需要 注意 ， 由 于 本 程序 使 用 到 了 网 络 功能 ， 而 访问 网 络 是 需要 声明 
权限 的 ， 因 此 我 们 还 得 修改 AndroidManifest.xml 文 件 ， 并 加 入 权限 声明 ， 如 
下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.webviewtest"> 


<uses-permission android:name="android.permission.INTERNET" /> 


</manifest> 


在 开始 运行 之 前 ， 首 先 需 要 保证 你 的 手机 或 模拟 器 是 联网 的 ， 如 采 你 使 用 
的 是 模拟 器 ， 只 需 保证 电脑 能 正常 上 网 即 可 。 然 后 就 可 以 运行 一 下 程序 
了 ， 效 末 如 图 9.1 所 示 。 


WebViewTest 


图 9.1 WebView 加 载 网 页 


可 以 看 到 ，WebViewTest 这 个 程序 现在 已 经 具备 了 一 个 简易 浏览 絮 的 功能 ， 
I 了 出 来 ， 还 可 以 通过 点 击 链接 浏 唤 更 多 的 网 
贡 。 
当然 ，WebView 还 有 很 多 更 加 高 级 的 使 用 技巧 ， 我 们 就 不 再 继续 进行 探讨 
了 ， 因 为 那 不 是 本 章 的 重点 。 这 里 先 介 绍 了 一 下 WebView 的 用 法 ， 只 是 硕 
望 你 能 对 HTTP 协 议 的 使 用 有 一 个 最 基本 的 认识 ， 接 下 来 我 们 束 要 利用 这 个 
协议 来 做 一 些 真 正 的 网 络 开 发 工作 了 。 


9.2 ”使 用 HTTP 协 议 访 问 网 络 


如 有 条 说 真 的 要 去 深入 分 机 HTTP 协 议 ， 可 能 需要 化 费 整 整 一 本 书 的 篇 幅 。 这 
里 我 当然 不 会 这 么 干 ， 因 为 毕竟 你 是 跟着 我 学 习 Android 开 发 的 ， 而 不 是 网 


站 开发 。 对 于 HTTP 协 议 ， 你 只 需要 稍微 了 解 一 些 束 足够 了 ， 它 的 工作 原理 
等 别 简 单 ， 束 是 客户 端 癌 服务 右 发 出 一 条 HTTP 请 求 ， 服 务 右 收 到 请 求 之 后 
会 返回 一 些 数据 给 客户 端 ， 然 后 客户 端 再 对 这 些 数据 进行 解 林 和 处 理 束 可 
以 了 。 是 不 是 非常 商 单 ? 一 个 浏览 郁 的 基本 工作 原理 也 就 是 如 此 了 “。 比 如 
说 上 一 节 中 使 用 到 的 WebView 探 件 ， 其 实 也 就 是 我 们 同 百 度 的 服务 器 发 起 
了 一 条 HTTP 请 求 ， 接 着 服务 器 分 析出 我 们 想 要 访问 的 是 百度 的 站 页 ， 于 是 
会 把 该 网 页 的 HTML 代 码 进行 返回 ， 然 后 WebView 再 调用 手机 浏览 侨 的 内 核 
对 返回 的 HTML 代 码 进行 解析 ， 最 终 将 页 面 展示 出 来 。 


简单 来 说 ，WebView 已 经 在 后 台 帮 有 我们 处 理 好 了 发 送 HTTP 请 求 、 接 收服 务 
响应 、 解 析 返 回 数据 ， 以 及 最 终 的 页 面 展示 这 几 步 工作 ， 不 过 由 于 它 封 装 
得 实在 是 太 好 了 ， 反 而 使 得 我 们 不 能 那么 直观 地 看 出 HTTP 协 议 到 底 是 如 何 
工作 的 。 因 此 ， 接 下 来 就 让 我 们 通过 手动 发 送 HTTP 请 求 的 方式 ， 来 更 加 深 
入 地 理解 一 下 这 个 过 程 。 


9.2.1 使 用 HttpURLConnection 


在 过 去 ，Android 上 发 送 HTTP 请 求 一 般 有 两 种 方式 : HttpURLConnection 和 
HttpClient。 不 过 由 于 HttpClient 存 在 API 数 量 过 多 、 扩 展 困 难 等 缺点 ， 
Android 团 队 越 来 越 不 建议 我 们 使 用 这 种 方式 。 终 于 在 Android 6.0 系 统 中 ， 
HttpClient 的 功能 被 完全 移 除 了 ， 标 志 着 此 功能 被 正式 弃 用 ， 因 此 本 小 节 我 
们 残 学 习 一 下 现在 官方 建议 使 用 的 HttpURLConnection 的 用 法 。 


首先 需要 获取 到 HttpURLConnection 的 实例 ， 一 般 只 需 new 出 一 个 URL 对 
象 ， 并 传 入 目标 的 网 络 地 址 ， 然后 调用 一 下 openconnection() 方法 即 可 ， 
如 下 所 示 : 


URL Url = new URL("http://www.baidu.com"); 
HttpURLConnection connection = (HttpURLConnection) url.openConnection(); 


在 得 到 了 HttpURLConnection 的 实例 之 后 ， 我 们 可 以 设置 一 下 HTTP 请 求 所 
使 用 的 方法 。 和 常用 的 方法 主要 有 两 个 : GET 和 POST 。GET 表示 和 硕 望 从 服务 右 
那里 获取 数据 ， 而 posT 则 表示 希望 提交 数据 给 服务 器 。 写 法 如 下 : 


connection.setRequestMethod("GET"); 


接 下 来 下 可 以 进行 一 些 目 由 的 定制 了 ， 比 如 设置 连接 超时 、 读 取 超 时 的 盈 
秒 数 ， 以 及 服务 器 希 望 得 到 的 一 些 消 轧 头等 。 这 部 分 内 容 根据 目 己 的 实际 
情况 进行 编写 ， 示 例 写法 如 下 : 


connection.setConnectTimeout(8000 ) ; 
connection.setReadTimeout (8000); 


之 后 再 调用 getInputStream() 方法 就 可 以 获取 到 服务 器 返回 的 输入 访 了 ) 
和 镜 下 的 任务 就 是 对 输入 流 进行 读 取 ， 如 下 所 示 : 


InputStream in = connection.getIinputStream(); 


最 后 可 以 调用 disconnect() 方法 将 这 个 HITTP 连 接 关 闭 掉 ， 如 下 所 示 : 


connection.disconnect(); 


下 面 就 让 我 们 通过 一 个 具体 的 例子 来 真正 体验 一 下 HttpURLConnection 的 用 
法 。 新 建 一 个 NetworkTest 项 目 ， 首 先 修 改 activity_main.xml 中 的 代码 ， 如 下 
所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<Button 
android:id="@+id/send_request" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Send Request" /> 


<ScrollView 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<TextView 
android:id="@+id/response_text" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" /> 
</ScrollView> 


</LinearLayout> 


主意 这 里 我 们 使 用 了 一 个 新 的 控件 : 它 是 用 来 做 什么 的 呢 ? 由 
于 手机 屏幕 的 空间 一 般 都 比较 小 ， 有 些 时 候 过 多 的 内 容 一 屏 是 显示 不 下 
的 ， 借 助 ScrollView 控 件 的 话 ， 我 们 i 就 可 以 以 深 动 的 形式 查看 屏幕 外 的 那 部 
分 内 容 。 另 外 ， 布 局 中 还 放置 了 一 个 Button 和 一 个 TextView，Button 用 于 发 
送 HITP 请 求 ，TextView 用 于 将 服务 器 返回 的 数据 显示 出 来 。 


接着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


莹 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


TextView responseText,; 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedIinstanceState); 
setcontentView(R.1layout.activity_main); 
Button sendRequest = (Button) findViewById(R.id,.send request); 
responseText = (TextView) findViewById(R.id.response_ text); 
sendRequest.setonclickListener(this); 


} 


Q@Override 
public void onClick(View v) { 
if (v.getId() == R.id.send request) { 
sendRequestwithHttpURLConnection(); 
} 


} 


private void sendRequestwWithHttpURLConnection() { 
// 开启 线程 来 发 起 网 络 请 求 
new Thread(new Runnable() { 
Q@override 
public void run() { 

HttpURLConnection connection = null; 

BufferedReader reader = null; 

try { 
URL url = new URL("https://www.baidu.com"); 
connection = (HttpURLConnection) url.openConnection(); 
connection.setRequestMethod("GET"); 
connection.setConnectTimeout(8000); 
connection.setReadTimeout(8000); 
InputStream in = connection.getIinputStream(); 
// 下 面 对 获 取 到 的 输入 流 进行 读 取 
reader = new BufferedReader (new InputStreamReader (in)); 
StringBuilder response = new StringBuilder(); 
String line; 
while ((line = reader.readLine()) != null) { 

response.append(line); 

} 


showResponse(response.toString()); 
} catch (Exception e) { 
e.printSstackTrace( ); 
} finally { 
if (reader != null) { 
try { 
reader .close() 
} catch (IOException e) { 
e.printStackTrace( ); 
} 


if (connection != null) { 
connection.disconnect(); 
} 
} 


J 
}).start(); 


private void showResponse(final String response) { 
runonUiThread(new Runnable() { 
@Override 
public void run() { 
// 在 这 里 进行 UI 操作 ， 将 结果 显示 到 界面 上 
responseText.setText(response); 


}); 


可 以 看 到 ， 我 们 在 Send Request 按 钮 的 点 击 事件 里 调用 了 


sendRequestwithHttpURLConnection() 方法 ， 在 这 个 方法 中 先是 开启 了 A 
子 线程 ， 然 后 在 子 线程 里 使 用 HttpURLConnection 发 出 一 条 HTTP 请 求 ， 请 
求 的 目标 地 址 就 是 百度 的 首页 。 接 着 利用 BufferedReader 对 服务 器 返回 的 流 
进行 读 取 ， 并 将 结果 传 入 到 了 showResponse() 方法 中 © 而 在 showResponse() 
方法 里 则 是 调用 了 一 人 1 runOonUiThread() 方法 ， 然 后 在 这 个 方法 的 匿名 类 参 
数 中 进行 操作 ， 将 返回 的 数据 显示 到 界面 上 。 那 么 这 里 为 什么 要 用 这 个 
runonUiThread() 方法 呢 ? 这 是 因为 Android 是 不 允许 在 子 线程 中 进行 UI 探 作 
的 ， 我 们 需要 通过 这 个 方法 将 线程 切换 到 主线 程 ， 然 后 再 更 新 UI 元 素 。 关 
于 这 部 分 内 容 ， 我 们 将 会 在 下 一 章 中 进行 详细 讲解 ， 现 在 你 只 需要 记得 必 
须 这 么 写 束 可 以 了 。 


完整 的 一 套 流程 惑 是 这 样 ， 不 过 在 开始 运行 之 前 ， 仍 然 别 专 了 要 声明 一 下 
网 络 权 限 。 修 改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.networktest"> 


<uses-permission android:name="android.permission.INTERNET" /> 


</manifest> 


好 了 ， 现 在 运行 一 下 程序 ， 并 点 击 Send Request 按 钮 ， 结 果 如 图 9.2 所 示 。 


NetworkTest 


SEND REQUEST 


图 9.2 服务 器 响应 的 数据 


征 不 是 看 得 头晕 眼花 ? 没 错 ， 服 务 右 返回 给 我 们 的 就 是 这 种 HTML 代 码 ， 只 
古 通 弟 情 况 下 浏览 如 都 会 将 这 些 代 码 解 析 成 漂亮 的 网 页 后 再 展示 出 来 。 


那么 如 琳 是 想 要 提交 数据 给 服务 器 应 该 怎么 办 呢 ? 其 实 也 不 复杂 ， 只 需 

将 HTTP 请 求 的 方法 改 成 PosT ， 并 在 获取 输入 流 之 前 把 要 提交 的 数据 写 出 即 
可 。 注 意 每 条 数据 都 要 以 键 值 对 的 形式 存在 ， 数 据 与 数据 之 间 用 “&” 符 号 隔 
开 ， 比 如 说 我 们 想 要 加 服务 融 提 交 用 户 名 和 密码 ， 束 可 以 这 样 写 : 


connection.setRequestMethod("POST"); 
DataOutputStream out = new DataoutputStream(connection.getoutputStream( ) ) ， 
out .writeBytes("username=admin&password=123456"); 


好 了 ， 相 信和 你 已 经 将 HttpURLConnection 的 用 法 很 好 地 掌握 了 。 


9.2.2 ”使 用 OkHttp 


当然 我 们 并 不 是 只 能 使 用 HttpURLConnection， 完 全 没有 任何 其 他 选择 ， 事 
实 上 在 开源 盛行 的 今天 ， 有 许多 出 色 的 网 络 通信 库 都 可 以 替代 原生 的 
HttpURLConnection， 而 其 中 OkHttp 无 疑 是 做 得 最 出 色 的 一 个 。 


OkHttp 是 由 易 易 大 名 的 Square 公司 开发 的 ， 这 个 公司 在 开源 事业 上 面 页 献 良 
多 ， 除 了 OkHttp 之 外 ， 还 开发 了 像 Picasso、Retrofit 等 著名 的 开源 项 目 。 
OkHttp 不 仅 在 接口 封装 上 面 做 得 简单 易 用 ， 就 连 在 底层 实现 上 也 是 目 成 一 
派 ， 比 起 原生 的 HttpURLConnection， 可 以 说 是 有 过 之 而 无 不 及 ， 现 在 已 经 
成 了 广大 Android 开 发 者 首选 的 网 络 通 信 库 。 那 么 本 小 和 我 们 吏 来 学 习 一 下 
OkHttp 的 用 法 ，OkHttp 的 项 目 主页 地 址 是 : https://github.com/square/okhttp 


Le] 


在 使 用 OkHttp 之 前 ， 我 们 需要 先 在 项 目 中 添加 OkHttp 库 的 依赖 。 编 辑 
app/build.gradle 文 件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android.support:appcompat-v7:24.2.1' 


testCompile ‘junit:junit:4.12"' 
compile 'com.squareup.okhttp3:okhttp:3.4.1" 
} 


添加 上 述 依赖 会 目 动 下载 两 个 库 ， 一 个 是 OkHttp 库 ， 一 个 是 Okio 库 ， 后 者 
征 前 者 的 通信 基础 。 其 中 3.4.1 征 我 写本 书 时 OkHttp 的 最 新 版 本 ， 你 可 以 访 
问 OkHttp 的 项 目 主页 来 得 看 当前 最 新 的 版 本 是 多 少 。 


下 面 我 们 来 看 一 下 OkHttp 的 具体 用 法 ， 首 先 需要 创建 一 个 OkHttpClient 的 实 
例 ， 如 下 所 示 : 


OkHttpClient client = new OkHttpClient(); 


接 下 来 如 果 想 要 发 起 一 条 HTTP 请 求 ， 束 需要 创建 一 个 Request 对 象 : 


Request request = new Request.Builder().build(); 


当然 ， 上 述 代 码 只 是 创建 了 一 个 空 的 Request 对 象 ， 并 没有 什么 实际 作用 ， 
我 们 可 以 在 最 终 的 build() 方法 之 前 连 组 很 多 其 他 方法 来 丰 主 这 个 Request 
对 象 。 比 如 可 以 通过 url() 方法 来 设置 日 标的 网 络 地 址 ， 如 下 所 示 : 


Request request = new Request.Builder() 
.Url("http://www.baidu.com") 
.build(); 


之 后 调用 OkHttpClient 的 newcal1() 方法 来 创建 一 个 call 对 象 ， 并 调用 它 的 
execute( ) 方法 来 发 送 请 求 并 获取 服务 器 返 回 的 数据 ， 写 法 如 下 : 


Response response = client.newCall(request).execute(); 


其 中 Response 对 和 象 号 吓 服 务 絮 返回 的 数据 了 ， 我 们 可 以 使 用 如 下 写法 来 得 
到 返回 的 具体 内 容 : 


String responseData = response.body().string(); 


如 有 果 是 发 起 一 条 posT 请 求 会 比 GET 请 求 稍 微 复杂 一 点 ， 我 们 需要 移 构建 出 一 
个 Request Body 对 象 来 存放 待 提交 的 参数 ， 如 下 所 未 : 


RequestBody requestBody = new FormBody.Builder() 
.add("username", "admin") 


.add("password", "123456") 
.build(); 


然后 在 Request.Builder 中 调用 一 下 post() 方法 ， 并 将 RequestBody 对 象 传 
入 : 


Request request = new Request .Builder() 
.Url("http://www.baidu.com") 
.post(requestBody) 

.build(); 


接 下 来 的 操作 残 和 GET 请 求 
服务 器 返回 的 数据 即 可 。 


好 了 ，OkHttp 的 基本 用 法 丈 移 学 到 这 里 ， 本 书 中 后 面 所 有 网 络 相关 的 功能 
我 们 都 将 会 使 用 OkHttp 来 实现 ， 到 时 候 再 进行 进一步 的 学 习 。 那 么 现在 我 
们 移 把 NetworkTest 这 个 项 目 改 用 OkHttp 的 方式 再 实现 一 届 吧 。 


Lg 所 以 现在 直接 修改 MainActivity 中 的 代码 ， 如 
下 所 示 : 


样 了 ， 调 用 execute( ) 方法 来 发 送 请 求 并 获取 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


Q@Override 
public void onClick(View v) { 
if (v.getId() == R.id.send_redquest) { 
sendRequestwithOkHttp(); 
} 


} 


private void sendRequestwWithOkHttp() { 
new Thread(new Runnable() { 
@Override 
public void run() { 
try { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
.Url("http://www.baidu.com") 
.build(); 
Response response = client.newCall(request).execute(); 
String responseData = response.body().string(); 
showResponse(responseData); 
} catch (Exception e) { 
e.printSstackTrace( ); 


} 
}).start(); 


这 里 我 们 并 没有 做 太 多 的 改动 ， 只 是 添加 了 一 个 sendRequestwithokHttp() 


方法 ， 并 在 Send Request 按 钮 的 点 击 事 件 里 去 调用 这 个 方法 。 在 这 个 方法 中 
同样 还 是 先 开 局 了 一 个 子 线程 ， 然 后 在 子 线程 里 使 用 OkHttp 发 出 一 条 HTTP 
请 求 ， 请 求 的 目标 地 址 还 是 百度 的 首页 ，OkHttp 的 用 法 也 正如 前 面 所 介绍 
的 一 样 。 最 后 仍然 还 是 调用 了 showResponse( ) 方法 来 将 服务 器 返回 的 数据 
显示 到 界面 上 。 


仅仅 是 改 了 这 么 多 代码 ， 现 在 我 们 残 可 以 重新 运行 一 下 程序 了 。 点 击 Send 
Request 按 钮 后 ， 你 会 看 到 和 上 一 小 下 中 同样 的 运行 结 采 ， 由 此 证 明 ， 使 用 
OkHttp 来 发 送 HTTP 请 求 的 功能 也 已 经 成 功 实现 了 。 


这 样 的 话 ， 相 信 你 就 已 经 把 HttpURLConnection 和 OkHttp 的 基本 用 法 都 掌握 
得 差不多 了 。 


9.3 ”解析 XML 格式 数据 


通常 情况 下 ， 每 个 需要 访问 网 络 的 应 用 程序 都 会 有 一 个 自己 的 服务 器 ， 我 
们 可 以 加 服务 夯 提 区 数据 ， 也 可 以 从 服务 右上 获取 数据 。 不 过 这 个 时 候 融 
出 现 了 一 个 问题 ， 这 些 数 据 到 搬 要 以 什么 样 的 格式 在 网 络 上 传输 呢 ? 随便 
传递 一 段 文本 肯定 十 不 行 的 ， 因 为 男 一 方 根本 束 不 会 知道 这 段 文 本 的 用 途 
征 什么 。 因 此 ， 一 般 我 们 都 会 在 网 络 上 传输 一 些 格式 化 后 的 数据 ， 这 种 数 
据 会 有 一 定 的 结构 规格 和 语义 ， 当 男 一 方 收 到 数据 消 恩 之 后 就 可 以 按照 相 
同 的 结构 规格 进行 解析 ， 从 而 取出 他 想 要 的 那 部 分 内 容 。 


在 网 络 上 传输 数据 时 最 常用 的 格式 有 两 种 : XML 和 JSON， 下 面 我 们 就 来 一 
个 一 个 地 进行 学 习 ， 本 节 首 先 学 习 一 下 如 何 解 析 XML 格 式 的 数据 。 


在 开始 之 前 我 们 还 需要 先 解决 一 个 问题 ， 就 是 从 哪儿 才能 获取 一 段 XML 格 
式 的 数据 呢 ? 这 里 我 准备 教 你 搭建 一 个 最 简单 的 Web 服 务 器 ， 在 这 个 服务 器 
上 提供 一 段 XML 文 本 ， 然 后 我 们 在 程序 里 去 访问 这 个 服务 器 ， 再 对 得 到 的 
XML 文本 进行 解析 。 


搭建 Web 服 务 絮 其 实 非 常 简 单 ， 有 很 多 的 服务 器 类 型 可 供 选 择 ， 这 里 我 准备 
使 用 Apache 服 务 器 。 站 先 你 需要 去 下 载 一 个 Apache 服 务 句 的 安装 包 ， 官 方 
下 载 地 址 是 : http:/httpd.apache.org/download.cgi 。 如 果 你 在 这 个 网 址 中 找 
不 到 Windows 厂 的 安装 包 ， 也 可 以 直接 在 百度 上 搜索 “Apache 服 务 器 下 载 ”， 
将 会 找到 很 多 下 载 链 接 。 


下 载 完 成 后 双击 束 可 以 进行 安装 了 ， 如 岁 9.3 所 示 。 


Welcome to the Installation Wizard for 
Apache HTTP Server 2.2.9 


The Installation Wizard will install Apache HTTP Server 2,2.9 on 
your computer, To continue, dick Next， 


WARNING: This program is protected by copyrightlaw and 
international treaties， 


图 9.3 Apache 服务 器 安装 界面 


然后 一 直 点 击 Next， 会 提示 让 你 输入 目 己 的 域名 ， 我 们 随便 填 一 个 域名 融 
可 以 了 ， 如 图 9.4 所 示 。 


Server Information 


Please enter your server's information, 


Network Domain (e.g. somenet.com) 


[test. com 


Server Name (e.g. www.somenet.com): 


[www. test,com 


Administrator's Email Address (e.g. webmaster@somenet.com): 
ltest@test.com 


Install Apache HTTP Server 2,2 programs and shortcuts for: 


©) for All Users, on Port 80, as a Service -- Recommended, 
中 ) only for the Current User, on Port 8080, when started Manually， 
InstallShield 


图 9.4 填 入 域名 和 服务 器 信息 


接着 继续 一 直 点 击 Next， 会 提示 让 你 选择 程序 安装 的 路 径 ， 这 里 我 选择 安 

装 到 C:\Apache 目 录 下 ， 之 后 再 继续 点 击 Next 就 可 以 完成 安装 了 。 安 装 成 功 

后 服务 器 会 目 动 局 动 起 来 ， 你 可 以 打开 电脑 的 浏览 如 来 验证 一 下 。 在 地 址 

0 如 琳 出 现 了 如 图 9.5 所 示 的 界面 ， 殊 说 明 服 务 器 已 经 启动 
功 了 了。 


< a 127.0.0.1 


It works! 


图 9.5 ”Apache 服务 器 的 默认 主页 


接 下 来 进入 到 C:NApache\htdocs 目 了 永 下 ， 在 这 里 新 建 一 个 名 为 get_data.xml 的 
文件 ， 然 后 编辑 这 个 文件 ， 并 加 入 如 下 XML 格式 的 内 容 。 


<id>1</id> 
<name>Google Maps</name> 
<version>1.0</version> 
</app> 
<app> 
<id>2</id> 
<name>Chrome</name> 
<version>2.1</version> 


</app> 
<app> 
<id>3</id> 
<name>Google Play</name> 
<version>2.3</version> 
</app> 
</apps> 


这 时 在 浏览 器 中 访问 http://127.0.0.1/get_data.xml 这 个 网 址 ， 就 应 该 出 现 如 图 
9.6 所 示 的 内 容 。 


|) 127.0.0.1/get_data.xml x 


€ (zal 白 127.0.0.1/get_data.xml 


This XL file does not appear to have any style information associated with it. The 
document tree is shown below. 


v 《apps> 
vapp> 
《id>1< id> 
<name26oogle Maps /rame> 
《versiorD1. 0C/version> 
</app> 
v<app> 
<id»2/ id> 
<name’Chr ome</name> 
《versiorD2. 1</ver sion> 
/app> 
v<app> 
《id>34 1d> 
name’Google Play /name> 
《versliorD2. 3C/version> 
</app> 
fapps> 


图 9.6 在 浏览 器 验证 XML 数据 


好 了 ， 准 备 工作 到 此 结束 ， 接 下 来 就 让 我 们 在 Android 程 序 里 去 获取 并 解析 
这 段 XML 数 据 吧 。 


9.3.1 Pull 解 析 方 式 


解析 XML 格 式 的 数据 其 实 也 有 挺 多 种 方式 的 ， 本 市 中 我 们 学 习 比 较 常用 的 
两 种 ，Pull 解 林 和 SAX 解 机。 那么 简单 起 见 ， 这 里 仍然 是 在 NetworkTest 项 目 
的 基础 上 继续 开发 ， 这 样 我们 束 可 以 重用 之 前 网 络 通信 部 分 的 代码 ， 从 而 
把 工作 的 重心 放 在 XML 数据 解 机 上 。 


既然 XML 格式 的 数据 已 经 提供 好 了 ， 现 在 要 做 的 就 是 从 中 解析 出 我 们 想 要 
得 到 的 那 部 分 内 容 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private void sendRequestwithokHttp() { 
new Thread(new Runnable() { 
Q@override 


public void run() 1{ 
try { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
// 指定 访问 的 服务 器 地 址 是 电脑 本 机 
.Url("http://10.0.2.2/get_data.xml") 
.build(); 
Response response = client.newCall(request).execute(); 
String responseData = response.body().string(); 
parseXMLWithPull(responseData); 
} catch (Exception e) { 
e.printSstackTrace( ); 
} 


} 
}).start(); 


private void parseXMLWithPull(String xmlData) { 
try { 
XmlPullParserFactory factory = XmlPullParserFactory.newInstance(); 
XmlPullParser xmlPullParser = factory.newPullParser(); 
xmlPullParser.setInput(new StringReader (xmlData)); 
int eventType = xmlPullParser.getEventType(); 
String id = ""; 
String name = ""，; 
String version = "",， 
while (eventType != XmlPullParser.END DOCUMENT) { 
String nodeName = xmlPullParser .getName(); 
switch (eventType) { 
// 开始 解析 某 个 节点 
case XmlPullParser.START_TAG: { 
if ("id".equals(nodeName)) { 
Id = xmlPullParser.nextText(); 
} else if ("name".equals(nodeName)) { 
name = xmlPullParser.nextText(); 
} else if ("version".equals(nodeName)) { 
version = xmlPullParser.nextText(); 
} 


break; 


. 
// 完成 解析 某 个 节点 
case XmlPullParser.END_TAG: { 
if ("app".equals(nodeName)) { 
Log.d("MainActivity", "id is " + id); 
Log.d("MainActivity", "name is " + name); 
Log.d("MainActivity", "version is " + version); 
} 


break; 


} 
default: 
break; 


} 


eventType = xmlPullParser.next(); 


} 
} catch (Exception e) { 
e,printStackTrace( ); 


可 以 看 到 ， 这 里 首先 是 将 HTTP 请 求 的 地 址 改 成 了 http:/10.0.2.2/get_data.xml 
，10.0.2.2 对 于 模拟 器 来 说 就 是 电脑 本 机 的 JP 地址 。 在 得 到 了 服务 絮 返 回 的 
数据 后 ， 我 们 并 不 再 直接 将 其 展示 ， 而 是 调用 了 parsexMLwithPul1() 方法 
来 解析 服务 器 返回 的 数据 。 


下 面 就 来 仔细 看 下 parsexMLwithpPul1L() 方法 中 的 代码 吧 。 这 里 首先 要 获取 
到 一 个 xmlPullParserFactory 的 实例 ， 并 借助 这 个 实例 得 到 xmLPullParser 
对 象 ， 然 后 调用 xm1lPullpParser 的 setInput() 方法 将 服务 器 返回 的 XML 数据 
设置 进去 承 可 以 开始 解析 了 “。 解 析 的 过 程 也 非常 简单 ， 通 过 getEventType( ) 
可 以 得 到 当前 的 解析 事件 ， 然 后 在 一 个 while 循 环 中 不 断 地 进行 解析 ， 如 果 
当前 的 解析 事件 不 等 于 XmlPullParserEND_DOCUMENT， 说 明 解 析 工 作 还 
没完 成 ， 调 用 next () 方法 后 可 以 获取 下 一 个 解析 事件 。 


在 while 循环 中 ， 我 们 通过 getName( ) 方法 得 到 当前 节点 的 名 字 ， 如 果 发 现 
节点 名 等 于 id、name 或 version， 束 调用 nextText() 方法 来 获取 世上 点 内 具体 
的 内 容 ， 每 当 解 析 完 一 个 app 玉 点 后 就 将 获取 到 的 内 容 打 印 出 来 。 


好 了 ， Ne 人 简单， 下 面 束 让 我 们 来 测试 一 下 吧 。 运 行 
NetworkTest 项 目 ， 然 后 点 击 Send Request 按 钮 ， 观 察 logcat 中 的 打印 日 志 ， 
如 图 9.7 所 示 。 


Verbose | (Q> 


com. example. networktest D/MainActivity: id is 1 


com. example. networktest D/MainActivity: name is Google Maps 
com. example. networktest D/MainActivity: version is 1.0 

com. example. networktest D/MainActivity: id is 2 

com. example. networktest D/MainActivity: name is Chrome 

com. example. networktest D/MainActivity: version is 2.1 

com. example. networktest D/MainActivity: id is 3 

com. example. networktest D/MainActivity: name is Google Play 


com. example. networktest D/MainActivity: version is 2.3 


图 9.7 打印 从 XML 中 解析 出 的 数据 
可 以 看 到 ， 我 们 已 经 将 XML 数据 中 的 指定 内 容 成 功 解析 出 来 了 。 


9.3.2 SAX 解析 方式 


Pull 解 析 方 式 虽然 非常 好 用 ， 但 它 并 不 是 我 们 唯一 的 选择 。SAX 解 析 也 是 一 
种 特别 利用 的 XML 解析 方式 ， 虽 然 它 的 用 法 比 Pul 解 析 要 复杂 一 些 ， 但 在 语 
义 方面 会 更 加 清楚 。 


通常 情况 下 我 们 都 会 新 建 一 个 类 继承 自 DefaultHandler ， 并 重 写 父 类 的 5 个 
方法 ， 如 下 所 示 : 


public class MyHandler extends DefaultHandler { 


Q@Override 
public void startDocument() throws SAXException { 


QOverride 
public void startElement(String uri, String localName, String qName, Attributes 
attributes) throws SAXException { 


Q@Override 
public void characters(char[] ch, int start, int length) throws SAXException { 


} 


QOverride 

public void endElement(String uri, String localName, String gqName) throws 
SAXException { 

} 


Q@Override 
public void endDocument() throws SAXException { 


这 5 个 方法 一 看 就 很 清楚 吧 ? startpocument() 方法 会 在 开始 XML 解析 的 时 
候 调 用 ，startElement () 方法 会 在 开始 解析 某 个 方 点 的 时 候 调 用 ， 
characters() 方法 会 在 获取 广 点 中 内 容 的 时 候 调 用 ，endElement() 方法 会 
在 完成 解析 某 个 节点 的 时 候 调 用 ，endpocument() 方法 会 在 完成 整个 XML 解 
析 的 时 候 调用 。 其 中 ， startElement() 、characters() 和 endElement() 这 3 
个 方法 是 有 参数 的 ， 从 XML 中 解析 出 的 数据 就 会 以 参数 的 形式 传 入 到 这 些 
方法 中 。 需 要 注意 的 是 ， 在 获取 节点 中 的 内 容 时 ，characters() 方法 可 能 
会 被 调用 多 次 ， 一 些 换行 符 也 被 当 作 内 容 解析 出 来 ， 我 们 需要 针对 这 种 情 
况 在 代码 中 做 好 控制 。 

那么 下 面 束 让 我 们 演 试 用 SAX 解 析 的 方式 来 实现 和 上 一 小 广 中 同样 的 功能 
吧 。 新 建 一 个 contentHandler 类 继承 自 DefaultHandler > 并 重 写 父 类 的 5 个 
方 计 汪 灯 下 所 示 : 


public class ContentHandler extends DefaultHandler { 


private String nodeName; 
private StringBuilder id; 
private StringBuilder name; 
private StringBuilder version; 


QOverride 

public void startDocument() throws SAXException { 
id = new StringBuilder(); 
name = new StringBuilder(); 
version = new StringBuilder(); 


} 


QOverride 

public void startElement(String uri, String localName, String qName, Attributes 
attributes) throws SAXException { 
// 记录 当前 节点 名 
nodeName = localName; 


} 


Q@Override 
public void characters(char[] ch, int start, int length) throws SAXException { 
// 根据 当前 的 节点 名 判断 将 内 容 添加 到 哪 一 个 StringBuilder 对 象 中 
If ("id".equals(nodeName)) { 
id.append(ch, start, length); 
} else if ("name".equals(nodeName)) { 
name.append(ch, start, length); 
} else if ("version".equals(nodeName)) { 
version.append(ch, start, length); 


} 
} 


QOverride 
public void endElement(String uri, String localName, String gqName) throws 
SAXException { 
if ("app".equals(localName)) { 
Log.d("ContentHandler", "id is " + id.toString().trim()); 
Log.d("ContentHandler", "name is " + name.toString().trim()); 
Log.d("ContentHandler", "version is " + version.toString().trim()); 
// 最 后 要 将 StringBuilder 清 空 掉 
id.setLength(0); 
name.setLength(0); 
version.setLength(0); 


} 


QOverride 
public void endDocument() throws SAXException { 
super.endDocument(); 


} 


可 以 看 到 ， 我 们 首先 给 id 、name 和 version 诈 
stringBuilder 对 象 ， 并 在 startDocument() 方法 里 对 


每 当 开 始 解析 某 个 节点 的 时 候 ，startElement() 方法 就 会 得 到 调用 ， 其 中 
localName 参数 记录 着 当前 节点 的 名 字 ， 这 里 我 们 把 它 记 录 下 来 。 接 着 在 解 
析 厄 点 中 具体 内 容 的 时 候 就 会 调用 characters() 方法 ， 我 们 会 根据 当前 的 

节点 名 进行 判断 ， 将 解析 出 的 内 容 添加 到 哪 一 个 stringeuilder 对 象 中 。 最 
后 在 endElement() 方法 中 进行 判断 ， 如 果 app 克 点 已 经 解析 完成 ， 束 打印 出 
id 、name 和 version 的 内 容 。 需 要 注意 的 是 ， 目 前 id 、name 和 version 中 
都 可 能 是 包括 回 车 或 换行 符 的 ， 因 此 在 打印 之 前 我 们 还 需要 调用 一 下 trim() 
方法 ， 并 且 打 印 完成 后 还 要 将 stringBuilder 的 内 容 清 空 挤 ， 不 然 的 话 会 影 
啊 下 一 次 内 容 的 读 取 。 


接 下 来 的 工作 束 非 党 简单 了 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private void sendRequestwWithOkHttp() { 
new Thread(new Runnable() { 
Q@Override 
public void run() 1{ 
try { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
// 指定 访问 的 服务 器 地 址 是 电脑 本 机 
.Url("http://10.0.2.2/get_data.xml") 
.build(); 
Response response = client.newCall(request).execute(); 
String responseData = response.body().string(); 
parseXMLWithSAX(responseData); 
} catch (Exception e) { 
e.printSstackTrace( ); 


} 


和 
}).start(); 


private void parseXMLWithSAX(String xmlData) { 

try { 
SAXParserFactory factory = SAXParserFactory.newInstance(); 
XMLReader xmlReader = factory.newSAXParser().getXMLReader(); 
ContentHandler handler = new ContentHandler(); 
// 将 ContentHandler 的 实例 设置 到 XMLReader 中 
xmlReader .setcontentHandler (handler); 
// 开始 执行 解析 
xmlReader .parse(new InputSource(new StringReader (xmlData))); 

} catch (Exception e) { 
e,printStackTrace( ); 


在 得 到 了 服务 器 返回 的 数据 后 ， 我 们 这 次 去 调用 parsexMLwithsAX( ) 方法 来 
解析 XML 数据 。parsexMLwithsAx( ) 方法 中 先是 创建 了 一 个 
SAXParserFactory 的 对 象 ， 然 后 再 获取 到 xMLReader 对 象 ， 接 着 将 我 们 编写 
的 ContentHandler 的 实例 设置 到 XMLReader 中 ， 最 后 调用 parse() 方法 开始 
执行 解析 就 好 了 。 


现在 重新 运行 一 下 程序 ， 点 击 Send Request 按 钮 后 观察 logcat 中 的 打印 日 
志 ， 你 会 看 到 和 图 9.7 中 一 样 的 结果 。 


除了 Pull 解 析 和 SAX 解 析 之 外 ， 其 实 还 有 一 种 DOM 解 析 方 式 也 算 挺 常用 
的 ， 不 这 这 时 我 们 就 不 再 展开 进行 讲解 了 ， 感 兴趣 的 话 你 可 以 自己 去 查阅 
一 下 相关 资料 。 


9.4 解析 JSON 格 式 数据 


现在 你 已 经 掌握 了 XML 格式 数据 的 解析 方式 ， 那 么 接 下 来 我 们 要 去 学 习 一 
下 如 何 解析 JSON 格 式 的 数据 了 。 比 起 XML ，JSON 的 主要 优势 在 于 它 的 体 
积 更 小 ， 在 网 络 上 传输 的 时 候 可 以 更 省 流量 。 但 缺点 在 于 ， 它 的 语义 性 较 
差 ， 看 起 来 不 如 XML 直观 。 


在 开始 之 前 ， 我 们 还 需要 在 C:\Apache\htdocs 目 录 中 新 建 一 个 get_data.json 的 
文件 ， 然 后 编辑 这 个 文件 ， 并 加 入 如 下 JSON 格 式 的 内 容 : 


"id":"5","version":"5.5", "name":"Clash of Clans"}, 
11 5 二 Version yy 
11 5 "ny nyersion":"3. 


"name":"Boom Beach"}, 
"name":"Clash Royale"}] 


oO" 
了 
5", 


这 时 在 浏览 器 中 访问 http://127.0.0.1/get_data.json 这 个 网 址 ， 束 应 该 出 现 如 
图 9.8 所 示 的 内 容 。 


[9 127.0.0.1/get_datajson x 用 汪汪 
所 © (D127.0.0.1/get data.json 


[{ id”:”5”, version” : “5.5”, name”: Clash of Clans”}, 
了 ‘n 
5 


ame” : Boom Beach”}, 


{"id” :6”, “version”:” , 
a a dah Rovale”}] 


fs 
(dn 0 


图 9.8 在 浏览 器 验证 JSON 数 据 
好 了 ， 这 样 我 们 把 JSON 格 式 的 数据 也 准备 好 了 ， 下 面 束 开始 学 习 如 何在 
Android 程 序 中 解析 这 些 数据 吧 。 


9.4.1 ”使 用 JSONObject 


类 似 地 ， 解 析 JSON 数 据 也 有 很 多 种 方法 ， 可 以 使 用 官方 提供 的 
JSONObject， 也 可 以 使 用 谷歌 的 开源 库 GSON。 男 外 ， 一 些 第 三 方 的 开源 库 
如 Jackson、FastJSON 等 也 非常 不 错 。 本 市 中 我 们 束 来 学 习 一 下 前 两 种 解析 
方式 的 用 法 。 


修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private void sendRequestwithokHttp() { 
new Thread(new Runnable() { 
@Override 
public void run() { 
try { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
// 指定 访问 的 服务 器 地 址 是 电脑 本 机 
.Urli("http://10.0.2.2/get_data.json") 


.build()， 
Response response = client.newCall(request).execute(); 
String responseData = response.body().string(); 
parseJSONWithJSONObject(responseData); 
} catch (Exception e) { 
e.printSstackTrace(); 
} 


} 
}).start(); 


private void parseJSONWithJSONObject(String jsonData) { 
try { 

JSONArray jsonArray = new JSONArray(jsonData); 

for (int i = 0; i < jsonArray.length(); i++) { 
JSONObject jsonobject = jsonArray.getJSONObject(i); 
String id = jsonObject.getString("id"); 
String name = jsonObject.getString("name"); 
String version = jsonObject.getString("version"); 
Log.d("MainActivity", "id is " + id); 
Log.d("MainActivity", "name is " + name); 
Log.d("MainActivity", "version is " + version); 


} 
} catch (Exception e) { 
e,printStackTrace( ); 


首先 记得 要 将 HTTP 请 求 的 地 址 改 成 http://10.0.2.2/get_data.json ， 然 后 在 得 
到 了 服务 器 返回 的 数据 后 调用 parseJsoNwithJsoNobject() 方法 来 解析 数 
据 。 可 以 看 到 ， 解 析 JSON 的 代码 真 的 非常 简单 ， 由 于 我 们 在 服务 器 中 定义 
的 是 一 个 JSON 数 组 ， 因 此 这 里 首先 是 将 服务 器 返回 的 数据 传 入 到 了 一 个 


JSO 


NArray 对 象 中 。 然 后 循环 遇 历 这 个 JsoNArray ， 从 中 取出 的 每 一 个 元 素 


都 是 一 个 JsoNobject 对 象 ， 每 个 JsoNobject 对 象 中 又 会 包含 id 、name 和 
version 这 些 数据 。 接 下 来 只 需要 调用 getstring() 方法 将 这 些 数据 取出 ， 
并 打印 出 来 即 可 。 


好 了 ， 就 是 这 么 简单 ! 现在 重新 运行 一 下 程序 ， 并 点 击 Send Request 按 钮 ， 
结果 如 图 9.9 所 示 。 


本 
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com. example. networktest D/MainActivity: id is 5 


com. example. networktest D/MainActivity: name is Clash of Clans 
com. example. networktest D/MainActivity: version is 5.5 
com. example. networktest D/MainActivity: id is 6 
com. example. networktest D/MainActivity: version is 7.0 
com. example. networktest D/MainActivity: id is 7 


/MainActivity: name is Clash Royale 


D 
D 
D 
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com. example. networktest D/MainActivity: name is Boom Beach 
D 
D 
com. example. networktest D 
D 


com. example. networktest D/MainActivity: version is 3.5 


图 9.9 打印 从 JSON 中 解析 出 的 数据 


9.4.2 ”使 用 GSON 


如 果 你 认为 使 用 JSONObject 来 解析 JSON 数 据 已 经 非常 简单 了 ， 那 你 就 太 容 
易 满 足 了 。 合 歌 提 供 的 GSON 开 源 库 可 以 让 解析 JSON 数 据 的 工作 简单 到 让 
你 不 敢 想 象 的 地 步 ， 那 我 们 肯定 是 不 能 错过 这 个 学 习 机 会 的 。 


不 过 GSON 并 没有 被 添加 到 Android 官 方 的 API 中 ， 因 此 如 采 想 要 使 用 这 个 功 
能 的 话 ， 束 必须 要 在 项 目 中 添加 GSON 库 的 依赖 。 编 辑 app/build.gradle 文 
件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
testCompile 'junit:junit:4.12"' 
compile 'com,.android,.support:appcompat-v7:24.2.1" 
compile 'com.squareup.okhttp3:okhttp:3.4.1" 
compile 'com.google.code.gson:gson:2.7' 


那么 GSON 库 究竟 是 神奇 在 哪里 呢 ? 其 实 它 主 要 了 就 是 可 以 将 一 段 JSON 格 式 
自动 映射 成 一 个 对 象 ， 从 而 不 需要 我 们 再 手动 去 编写 代码 进行 解 
J 


比如 说 一 段 JSON 格 式 的 数据 如 下 所 示 : 


{"name":"Tom", "age":20} 


| 


那 我 们 殉 可 以 定义 一 个 Person 类 ， 并 加 入 name 和 age 这 两 个 字段 ， 然 后 只 
需 简单 地 调用 如 下 代码 就 可 以 将 JSON 数 据 自动 解析 成 一 个 Person 对 象 了 : 


Gson gson = new GSson( ) 
Person person = gson.fromJson(jsonData, Person.class); 


如 果 需 要 解析 的 是 一 段 JSON 数 组 会 稍微 麻烦 一 点 ， 我 们 需要 借助 TypeToken 
i 


List<Person> people = gson.fromJson(jsonData, new TypeToken<List<Person>>() {}.getType()); 


好 了 ， 基 本 的 用 法 就 是 这 样 ， 下 面 就 让 我 们 来 真正 地 演 试 一 下 吧 。 首 先 狐 
增 一 个 App 类 ， 并 加 入 id 、name 和 version 这 3 个 字段 ， 如 下 所 示 : 


public class App { 


private String id; 
private String name; 
private String version,; 
public String getId() { 


return id; 
} 


public void setId(String id) { 
this.id = id; 
上 


public String getName() { 
return name 
} 


public void setName(String name) { 
this.name = name; 
} 


public String getVersion() { 
return version; 
} 


public void setVersion(String version) { 
this.version = version,; 
} 


| | 


然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private void sendRequestwWithOkHttp() { 
new Thread(new Runnable() { 
Q@Override 
public void run() { 
try { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
// 指定 访问 的 服务 器 地 址 是 电脑 本 机 
.Url("http://10.0.2.2/get_data.json") 
.build(); 
Response response = client.newCall(request).execute(); 
String responseData = response.body().string(); 
parseJSONWithGSON(responseData); 
} catch (Exception e) { 
e.printStackTrace() ， 
} 


} 
}).start(); 


private void parseJSONWithGSON(String jsonData) { 

Gson gson = new Gson(); 

List<App> appList = gson.fromJson(jsonData, new TypeToken<List<App>>() 
{}.getType( )); 

for (App app : appList) { 
Log.d("MainActivity", "id is " + app.getId()); 
Log.d("MainActivity", "name is " + app.getName()); 
Log.d("MainActivity", "version is " + app.getVersion()); 


现在 重新 运行 程序 ， 点 击 Send Request 按 钮 后 观察 logcat 中 的 打印 日 志 ， 你 
会 看 到 和 图 9.9 中 一 样 的 结果 。 


好 了 ， 这 样 我 们 就 算是 把 XML 和 JSON 这 两 种 数据 格式 最 常用 的 儿 种 解析 方 
法 都 学 习 完 了 ， 在 网 络 数据 的 解析 方面 ， 你 已 经 成 功 毕 业 了 。 


9.5 ”网 络 编程 的 最 佳 实践 


目前 你 已 经 掌握 了 HttpURLConnection 和 OkHttp 的 用 法 ， 知 道 了 如 何 发 起 
HTTP 请 求 ， 以 及 解析 服务 器 返回 的 数据 ， 但 也 许 你 还 没有 发 现 ， 之 前 我 们 
的 写法 其 实 是 很 有 问题 的 。 因 为 一 个 应 用 程序 很 可 能 会 在 许多 地 方 都 使 用 
到 网 络 功能 ， 而 发 送 HTTP 请 求 的 代码 基本 都 是 相同 的 ， 如 果 我 们 每 次 都 去 
编写 一 遇 发 送 HITTP 请 求 的 代码 ， 这 显然 是 非常 差劲 的 做 法 。 


没 错 ， 通 常情 况 下 我 们 都 应 该 将 这 些 通 用 的 网 络 操 作 提 取 到 一 个 公共 的 类 
里 ， 并 提供 一 个 静态 方法 ， 当 想 要 发 起 网 络 请 求 的 时 候 ， 只 需 简 单 地 调用 
一 下 这 个 方法 即 可 。 比 如 使 用 如 下 的 写法 : 


public class HttpUtil { 


public static String sendHttpRequest(String address) { 

HttpURLConnection connection = null; 

try { 
URL Url = new URL(address); 
connection = (HttpURLConnection) url.openConnection(); 
connection.setRequestMethod( "GET"); 
connection.setConnectTimeout(8000); 
connection.setReadTimeout(8000); 
connection.setDoInput(true); 
connection.setDoOutput(true); 
InputStream in = connection.getInputStream( ) ， 
BufferedReader reader = new BufferedReader(new InputStreamReader(in))， 
StringBuilder response = new StringBuilder(); 
String line; 
while ((line = reader.readLine()) != nul1) { 

response.append(line); 


return response.toString(); 
} catch (Exception e) { 
e,printStackTrace( ); 
return e.getMessage(); 
} finally { 
if (connection != null) 区 
connection.disconnect(); 


以 后 每 当 需 要 发 起 一 条 HTTP 请 求 的 时 候 就 可 以 这 样 写 : 


String address = "http://www.baidu.com"; 
String response = HttpUtil.sendHttpRequest(address); 


在 获取 到 服务 器 啊 应 的 数据 后 ， 我 们 束 可 以 对 它 进行 解析 和 处 理 了 。 但 是 
需要 注意 ， 网 络 请 求 通常 都 是 属于 耗 时 操作 ， 而 sendhttpRequest() 方法 的 
内 部 并 没有 开启 线程 这 样 就 有 可 能 导致 在 调用 sendhttpRequest() 方法 的 
时 候 使 得 主线 程 被 阻塞 住 。 


你 可 能 会 说 ， 很 简单 嘛 ， 在 sendHttpRequest() 方法 内 部 开启 一 个 线程 不 就 
解决 这 个 问题 了 吗 ? 其 实 没 有 你 想象 中 的 那么 容易 ， 因 为 如 果 我 们 在 
sendHttpRequest() 方法 中 开局 了 一 个 线程 来 发 起 HTTP 请 求 ， 那 么 服务 器 
响应 的 数据 是 无 法 进行 返回 的 ， 所 有 的 耗 时 逻辑 都 是 在 子 线程 里 进行 的 ， 
sendHttpRequest() 方法 会 在 服务 器 还 没 来 得 及 响应 的 时 候 就 执行 结束 了 ， 
当然 也 就 无 法 返回 响应 的 数据 了 。 


那么 遇 到 这 种 情况 时 应 该 怎么 办 昵 ? 其 实 解决 方法 并 不 难 ， 只 需要 使 用 Java 
和 可 以 了 ， 下 面 束 让 我 们 来 学 习 一 下 回调 机 制 到 底 古 如 何 使 用 


首先 需要 定义 一 个 接口 ， 比如 将 它 命名 成 HttpCallbackListener， 代 码 如 下 所 
修 : 


public interface HttpCallbackListener { 


void onFinish(String response); 


void onError(Exception e); 


可 以 看 到 ， 我 们 在 接口 中 定义 了 两 个 方法 ， onFinish() 方法 表示 当 服 务 右 
成 功 响应 我 们 请 求 的 时 候 调 用 ，onError() 表示 当 进 行 网 络 操作 出 现 错误 的 
时 候 调 用 。 这 两 个 方法 都 带 有 参数 ，onFinish() 方法 中 的 参数 代表 着 服务 
器 返回 的 数据 ， 而 onError() 方法 中 的 参数 记录 着 错误 的 详细 信息 。 


接着 修改 HttpUtl 中 的 代码 ， 如 下 所 示 : 


public class HttpUtil { 


public static void sendHttpRequest(final String address, final 
HttpCallbackListener listener) { 
new Thread(new Runnable() { 
Q@Override 
public void run() { 
HttpURLConnection connection = null; 
try { 
URL url = new URL(address); 


connection = (HttpURLConnection) url.openConnection(); 

connection.setRequestMethod("GET"); 

connection.setConnectTimeout(8000); 

connection,setReadTimeout(8000 ) ， 

connection,.setDoInput(true); 

connection,.setDoOutput(true); 

InputStream in = connection.getInputStream( ) ， 

BufferedReader reader = new BufferedReader(new InputStreamReader 
(in)); 

StringBuilder response = new StringBuilder(); 

String line; 

while ((line = reader.readLine()) != null) { 
response.append(line); 


} 

if (listener != null) { 
// 回调 onFinish( ) 方 法 
listener.onFinish(response.toString()); 


} catch (Exception e) { 
if (listener != null) { 
// 回调 onError() 方 法 
listener.onError(e); 


} 
} finally { 
if (connection != null) { 
connection.disconnect(); 
上 


} 


} 
}).start(); 


我 们 首先 给 sendHttpRequest() 方法 次 加 了 一 HttpCallbackListener 参 


数 ， 并 在 方法 的 内 部 开局 了 一 个 子 线程 ， 然 后 在 子 线程 里 去 执行 具体 的 网 
络 操 作 。 注 意 ， 子 线程 中 是 无 法 通过 return 语句 来 返回 数据 的 ， 因 此 这 里 


\ 


我 们 将 服务 器 啊 应 的 数据 传 入 了 HttpCallbackListener 的 onFinish() 方法 中 ， 
如 果 出 现 了 异 销 束 将 异常 原因 传 入 到 onError() 方法 中 。 


现在 sendHttpRequest() 方法 接收 两 个 参数 了 ， 因此 我 们 在 调用 它 的 时 候 还 
需要 将 HttpCallbackListener 的 实例 传 入 ， 如 下 所 示 : 


HttpUtil.sendHttpRequest(address, new HttpCallbackListener() { 
Q@Override 
public void onFinish(String response) { 


// 在 这 里 根据 返回 内 容 执行 具体 的 逻辑 


} 


QOverride 
public void onError(Exception e) { 
// 在 这 里 对 异常 情况 进行 处 理 


| | 


这 样 的 话 ， 当 服务 器 成 功 啊 应 的 时 候 ， 我 们 束 可 以 在 onFinish() 方法 里 对 
啊 应 数据 进行 处 理 了 。 类 似 地 ， 如 采 出 现 了 异 第 ， 就 可 以 在 onError() 方法 
里 对 异 第 情况 进行 处 理 。 如 此 一 来 ， 我 们 避 ® 巧 妙 地 利用 回调 机 制 将 响应 数 
据 成 功 返 回 给 调用 方 了 。 


不 过 你 会 发 现 ， 上 述 使 用 HttpURLConnection 的 写法 总 体 来 说 还 是 比较 复杂 
的 ， 那 么 使 用 OkHttp 会 变 得 简单 吗 ? 答案 是 肯定 的 ， 而 且 要 简单 得 多 ， 下 
面 我 们 来 具体 看 一 下 。 在 HttpUtil 中 加 入 一 个 sendokHttpRequest() 方法 ， 如 
下 所 示 : 


public class HttpUtil { 


public static void sendOkHttpRequest(String address, okhttp3.Callback callback) { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
.Url(address) 
.build(); 
client.newCall(request).enqueue(callback); 


可 以 看 到 ， sendOkHttpRequest() 方法 中 有 一 人 1 okhttp3.cCallback 参数 ， 这 
个 是 OkHttp 库 中 目 市 的 一 个 回调 接口 ， 类 似 于 我 们 刚才 目 己 编写 的 
HttpCallbackListener。 然 后 在 client .newcall( ) 之 后 没有 像 之 前 那样 一 直 调 
用 execute() 方法 ， 而 是 调用 了 一 个 enqueue() 方法 ， 并 把 okhttp3.callback 
参数 传 入 。 相 信和 聪明 的 你 已 经 猪 到 了 ，OkHttp 在 enqueue() 方法 的 内 部 已 经 
帮 我 们 开 好 子 线程 了 ， 然 后 会 在 子 线程 中 去 执行 HTTP 请 求 ， 并 将 最 终 的 请 
求 结 果 回 调 到 okhttp3.callback 当中 。 


那么 我 们 在 调用 sendokHttpRequest() 方法 的 时 候 就 可 以 这 样 写 : 


HttpUtil.sendOkHttpRequest("http://www.baidu.com", new okhttp3.Callback() { 


Q@Override 
public void onResponse(Call call, Response response) throws IOException { 
// 得 到 服务 器 返回 的 具体 内 容 


String responseData = response.body().string(); 


Q@Override 
public void onFailure(Call call, IOException e) { 


// 在 这 里 对 异常 情况 进行 处 理 


由 此 可 以 看 出 ，OkHttp 的 接口 设计 得 确实 非常 人 性 化 ， 它 将 一 些 瘦 用 的 功 


能 进行 了 很 好 的 封 狠 ， 使 得 我 们 只 需 编写 少量 的 代码 就 能 完成 较为 复杂 的 
网 络 操作 。 当 然 这 并 不 是 OkHttp 的 全 部 ， 后 面 我 们 还 会 继续 学 习 它 的 其 他 
相关 知识 。 


另外 需要 注意 的 是 ， 不 管 是 使 用 HttpURLConnection 还 是 OkHttp， 最 终 的 回 
调 接口 都 还 是 在 子 线程 中 运行 的 ， 因 此 我 们 不 可 以 在 这 里 执行 任何 的 UI 操 
作 ， 除非 借助 runonuiThread() 方法 来 进行 线程 转换 。 至 于 具体 的 原因 ， 我 
们 很 快 就 会 在 下 一 间 中 学 习 到 了 。 


9.6 ”小结 与 点 评 


本 章 中 我 们 主要 学 习 了 在 Android 中 使 用 HTTP 协 议 来 进行 网 络 交互 的 知识 ， 
虽然 Android 中 文 持 的 网 络 通信 协议 有 很 多 种 ， 但 HTTP 协 议 无 疑 是 最 常用 的 
一 种 。 通 常 我 们 有 两 种 方式 来 发 送 HTTP 请 求 ， 分 别 是 HttpURLConnection 
和 OkHttp， 相 信 这 两 种 方式 你 都 已 经 很 好 地 掌握 了 。 


接着 我 们 又 学 习 了 XML 和 JSON 格 式 数 据 的 解析 方式 ， 因 为 服务 右 啊 应 给 我 
们 的 数据 一 般 都 是 属于 这 两 种 格式 的 。 无 论 是 XML 还 是 JSON， 它 们 各 目 双 
拥有 多 种 解析 方式 ， 这 里 我 们 只 是 学 习 了 最 利用 的 几 种 ， 如 采 以 后 你 的 工 
作 中 还 需要 用 到 其 他 的 解析 方式 ， 可 以 自行 去 学 习 。 


本 章 的 最 后 同样 是 最 佳 实践 环 生 ， 在 这 次 的 最 佳 实践 中 ， 我 们 主要 学 习 了 
如 何 利用 Java 的 回调 机 制 来 将 服务 器 响应 的 数据 进行 返回 。 其 实 除 此 之 外 ， 
还 有 很 多 地 方 都 可 以 使 用 到 Java 的 回调 机 制 ， 和 希望 你 能 举一反三 ， 以 后 在 其 
他 地 方 需要 用 到 回调 机 制 时 都 能 够 灵活 地 使 用 。 


在 进行 了 一 章 多 媒体 和 一 章 网 络 的 相关 知识 学 习 后 ， 你 是 否 想起 来 Android 
四 大 组 件 中 还 剩 一 个 没有 学 过 呢 ! 那么 下 面 就 让 我 们 进入 到 Android 服 务 的 
学 习 旅程 之 中 。 


第 10 章 后 台 默 默 的 劳动 者 一 一 探 
完 服务 


记得 在 我 上 大 学 的 时 候 ，iPhone 是 属于 少数 人 才 拥 有 的 稀有 物品 ，Android 
甚至 还 没 面世 ， 那 个 时 候 全 球 的 手机 市 场 是 由 诺基亚 统治 着 的 。 当 时 我 沉 
得 诡 基 亚 的 Symbian 操作 系统 做 得 特别 出 色 ， 因 为 比 起 一 般 的 手机 ， 它 可 以 
文 持 后 台 功 能 。 那 个 时 候 能 够 一 边 打 着 电话 、 听 着 音乐 ， 一 边 在 后 台 挂 者 
QQ 是 件 非 常 酷 的 事情 。 所 以 我 也 曾经 单纯 地 认为 ， 文 持 后 侣 的 手机 束 是 知 


能 手机 。 


而 如 今 ，Symbian 早 已 风光 不 再 ，Android 和 iOS 几 乎 占据 了 智能 手机 全 部 的 
市 场 份 额 。 在 这 两 大 移动 操作 系统 中 ，iOS 一 开始 是 不 支持 后 台 的 ， 后 来 逐 
渐 意 识 到 这 个 功能 的 重要 性 ， 才 加 入 了 后 台 功 能 。 而 Android 则 是 沿用 了 
Symbian 的 老 习 惯 ， 从 一 开始 就 支持 后 台 功 能 ， 这 使 得 应 用 程序 即使 在 关闭 
的 情况 下 仍然 可 以 在 后 台 继 续 运 行 。 不 管 怎么 说 ， 后 台 功 能 属于 四 大 组 件 
之 一 ， 其 重要 程度 不 言 而 喻 ， 那 么 我 们 自然 要 好 好 学 习 一 下 它 的 用 法 了 。 


10.1 服务 是 什么 


服务 (Service) 是 Android 中 实现 程序 后 台 运 行 的 解决 方案 ， 它 非常 适合 
执行 那些 不 需要 和 用 户 交 互 而 且 还 要 求 长 期 运行 的 任务 。 服 务 的 运行 不 依 
赖 于 任何 用 户 界 面 ， 即 使 程序 被 切换 到 后 台 ， 或 者 用 户 打 开 了 男 外 一 个 应 
用 程序 ， 服 务 仍然 能 够 保持 正常 运行 。 


不 过 需要 注意 的 是 ， 服 务 并 不 是 运行 在 一 个 独立 的 进程 当中 的 ， 而 是 依赖 
于 创建 服务 时 所 在 的 应 用 程序 进程 。 当 某 个 应 用 程序 进程 被 杀 掉 时 ， 所 有 
依赖 于 该 进程 的 服务 也 会 停止 运行 。 


另外 ， 也 不 要 被 服务 的 后 台 概 念 所 迷惑 ， 实 际 上 服务 并 不 会 目 动 开局 线 
程 ， 所 有 的 代码 都 是 默认 运行 在 主线 程 当 中 的 。 也 就 是 说 ， 我 们 需要 在 服 
务 的 内 部 手动 创建 子 线程 ， 并 在 这 里 执行 具体 的 任务 ， 否 则 驶 有 可 能 出 现 
主线 程 被 阻塞 住 的 情况 。 那 么 本 章 的 第 一 党 课 ， 我 们 就 先 来 学 习 一 下 关于 
Android 多 线程 编程 的 知识 。 


10.2 ” Android 多 线程 编程 


熟悉 Java 的 你 ， 对 多 线程 编程 一 定 不 会 陌生 吧 。 当 我 们 需要 执行 一 些 耗 时 操 
作 ， 比 如 说 发 起 一 条 网 络 请 求 时 ， 考 虑 到 网 速 等 其 他 原因 ， 服 务 希 未 必 会 
立刻 啊 应 我 们 的 请 求 ， 如 采 不 将 这 类 操作 放 在 于 线程 里 去 运行 ， 束 会 导致 
主线 程 被 阻塞 住 ， 从 而 影响 用 户 对 软件 的 正常 使 用 。 那 么 吏 让 我 们 从 线程 
的 基本 用 法 开始 学 习 吧 。 


10.2.1 ”线程 的 基本 用 法 


Android 多 线程 编程 其 实 并 不 比 Java 多 线程 编程 特殊 ， 基本 都 是 使 用 相同 的 
语法 。 比 如 说 ， 定 义 一 个 线程 只 需要 新 建 一 个 类 继承 自 Thread ， 然 后 重 写 
父 类 的 run() 方法 ， 并 在 里 面 编写 耗 时 逻辑 即 可 ， 如 下 所 示 : 


class MyThread extends Thread { 


Q@Override 
public void run() 区 
// 处 理 具体 的 逻辑 


那么 该 如 何 启动 这 个 线程 呢 ? 其 实 也 很 简单 ， 只 需要 new 出 MyThread 的 实 
例 ， 然 后 调用 它 的 start() 方法 ， 这 样 run( ) 方法 中 的 代码 束 会 在 于 线程 当 
i 


new MyThread().start(); 


当然 ， 使 用 继承 的 方式 籼 合 性 有 点 高 ， 更 多 的 时 候 我 们 都 会 选择 使 用 实现 
Runnable 接口 的 方式 来 定义 一 个 线程 ， 如 下 所 示 : 


class MyThread implements Runnable { 


Q@Override 
public void run() 区 
// 处 理 具体 的 逻辑 


| | 


如 采 使 用 了 这 种 写法 ， 局 动 线程 的 方法 也 需要 进行 相应 的 改变 ， 如 下 所 
人 小 : 


MyThread myThread = new MyThread(); 
new Thread(myThread).start(); 


可 以 看 到 ，Thread 的 构造 玉 数 接收 一 个 Runnable 参数 ， 而 我 们 new 出 的 
MyThread 正 是 一 个 实现 了 Runnable 接口 的 对 象 ， 所 以 可 以 直接 将 它 传 入 到 
Thread 的 构造 函数 里 。 接 着 调用 Thread 的 start() 方法 ，run() 方法 中 的 代 
码 就 会 在 子 线 程 当 中 运行 了 。 


当然 ， 如 有 果 你 不 想 专门 再 定义 一 个 类 去 实现 Runnable 接口 ， 也 可 以 使 用 匿 
名 类 的 方式 ， 这 种 写法 更 为 第 见 ， 如 下 所 示 : 


new Thread(new Runnable() { 


Q@Override 
public void run() { 


// 处 理 具体 的 逻辑 


}).start(); 


以 上 几 种 线程 的 使 用 方式 相信 你 都 不 会 感到 陌生 ， 因 为 在 Java 中 创建 和 启动 
线程 也 是 使 用 同样 的 方式 。 了 解 了 线程 的 基本 用 法 后 ， 下 面 我 们 来 看 一 下 
Android 多 线程 编程 与 Java 多 线程 编程 不 同 的 地 方 。 


10.2.2 ”在 子 线程 中 更 新 UI 


和 许多 其 他 的 GUI 库 一 样 ，Android 的 UI 也 是 线程 不 安全 的 。 也 就 是 说 ， 如 
果 想 要 更 狐 应 用 程序 里 的 UI 元 素 ， 则 必须 在 主线 程 中 进行 ， 否 则 就 会 出 现 
异常 。 

眼见 为 实 ， 让 我 们 通过 一 个 具体 的 例子 来 验证 一 下 吧 。 新 建 一 个 
AndroidThreadTest 项 目 ， 然 后 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/change_text" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Change Text" /> 


<TextView 
android:id="@+id/text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_centerInpParent="true" 
android:text="Hello world" 
android:textSize="20sp" /> 


</RelativeLayout> 


布局 文件 中 定义 了 两 个 控件 ，TextView 用 于 在 屏幕 的 正中 央 显 示 一 个 Hello 
world 字 从 串 ，Button 用 于 改变 TextView 中 显示 的 内 容 ， 我 们 希望 在 点 击 
Button 后 可 以 把 TextView 中 显示 的 字符 串 改 成 Nice to meet you 。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private TextView text; 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
text = (TextView) findViewById(R.id.text); 
Button changeText = (Button) findViewById(R.id.change_ text); 
changeText.setonclickListener(this); 


} 


Q@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.change_ text: 
new Thread(new Runnable() { 
Q@Override 
public void run() { 
text.setText("Nice to meet you"); 
} 


}).start(); 

break; 
default: 

break; 


可 以 看 到 ， 我 们 在 Change Text 按 钮 的 点 击 事 件 里 面 开启 了 一 个 子 线程 ， 然 
后 在 子 线程 中 调用 TextView 的 setText() 方法 将 显示 的 字符 串 改 成 Nice to 
meet you。 代 码 的 逻辑 非常 简单 ， 只 不 过 我 们 是 在 子 线程 中 更 狐 UI 的 。 现 在 
并 点 击 Change Text 按 钮 ， 你 会 发 现 程序 果然 前 泪 了 ， 如 图 
10.1 所 示 。 


AndroidThreadTest has stopped 


GC Openappagain 


图 10.1 在 子 线程 中 更 新 UI 导 致 裔 溃 


然后 观察 logcat 中 的 错误 日 志 ， 可 以 看 出 是 由 于 在 子 线程 中 更 新 UI 所 导致 
的 ， 如 图 10.2 所 示 。 


android. view. ViewRootImpl$CalledFromNroneThreadException: Only the original 
thread that created a view hierarchy can touch its views. 


图 10.2 月 省 的 详细 信息 


由 此 证 实 了 Android 确 实 是 不 允许 在 子 线程 中 进行 UI 操作 的 。 但 是 有 些 时 

候 ， 我 们 必须 在 了 于 线程 里 去 执行 一 些 耗 时 任务 ， 然 后 根据 任务 的 执行 结 末 
来 更 新 相应 的 UI 控件 ， 这 该 如 何 是 好 呢 ? 

对 于 这 种 情况 ，Android 提 供 了 一 套 异 步 消 忌 处 理 机 制 ， 完 美 地 解决 了 在 子 
线程 中 进行 UI 操作 的 问题 。 本 小 市 中 我 们 先 来 学 习 一 下 异步 消 奶 处 理 的 使 
用 方法 ， 下 一 小 节 中 再 去 分 析 它 的 原理 。 


修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 
public static final int UPDATE_TEXT = 1; 
private TextView text; 
private Handler handler = new Handler() { 
public void handleMessage(Message msg) { 
Switch (msg.what) { 
case UPDATE_TEXT: 


// 在 这 里 可 以 进行 UI 操作 
text.setText("Nice to meet you"); 


break; 
default: 
break; 
站 
} 
}; 
QOverride 


public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.change_ text: 
new Thread(new Runnable() { 
@Override 
public void run() { 
Message message = new Message(); 
message.what = UPDATE_TEXT， 
handler .sendMessage(message); // 将 Message 对 象 发 送出 去 


} 
}).start(); 
break; 

default: 
break; 


这 里 我 们 先是 定义 了 一 个 整 型 常量 uppATE_TEXT ， 用 于 表示 更 新 TextView 这 
个 动作 。 然 后 新 增 一 个 Handler 对 象 ， 并 重 写 父 类 的 handleMessage( ) 方 
法 ， 在 这 里 对 具体 的 Message 进 行 处 理 。 如 果 发 现 Message 的 what 字段 的 值 
等 于 UPDATE_TEXT ， 就 将 TextView 显 示 的 内 容 改 成 Nice to meet you。 


下 面 再 来 看 一 下 Change Text 按 钮 的 点 击 事件 中 的 代码 。 可 以 看 到 ， 这 次 我 
们 并 没有 在 子 线程 里 直接 进行 UI 操 作 ， 而 是 创建 了 一 个 Message 
(android.os.Message ) 对 象 ， 并 将 它 的 what 字段 的 值 指定 为 UPDATE_TEXT 
然后 调用 Handler 有 的 sendMessage() 方法 将 这 条 Message 发 送出 去 > 很 快 ， 
Handler 束 会 收 到 这 条 Message， 并 在 handleMessage( ) 方法 中 对 它 进 行 处 
理 。 注 意 此 时 handleMessage() 方法 中 的 代码 就 是 在 主线 程 当中 运行 的 了 ， 
所 以 我 们 可 以 放心 地 在 这 里 进行 UI 操作 。 接 下 来 对 Message 携 带 的 what 字段 
的 值 进行 判断 ， 如 果 等 于 uPDATE_TEXT ， 就 将 TextView 显 示 的 内 容 改 成 Nice 
to meet you 。 


现在 重 狐 运行 程序 ， 可 以 看 到 屏幕 的 正中 央 显 示 着 Hello world。 然 后 点 击 一 
下 Change Text 按 钮 ， 显 示 的 内 容 束 被 督 换 成 Nice to meet you， 如 图 10.3 所 
Zz“。 


AndroidThreadTest 


CHANGE TEXT 


Nice to meet you 


图 10.3 ”成 功 替 换 显 示 的 文字 


这 样 你 就 已 经 掌握 了 Android 异 步 消息 处 理 的 基本 用 法 ， 使 用 这 种 机 制 就 可 
以 出 色 地 解决 授 在 子 线程 中 更 新 UI 的 问题 。 不 过 人 奶 怕 你 对 它 的 工作 原理 还 
ee 下 面 我 们 就 来 分 析 一 下 Android 异 步 消 息 处 理 机 制 到 底 是 如 何 
工作 的 。 


10.2.3 ”解析 异步 消息 处 理 机 制 


Android 中 的 异步 消息 处 理 主要 由 4 个 部 分 组 成 : Message、Handler、 
MessageQueue 和 Looper。 其 中 Message 和 Handler 在 上 一 小 和 中 我 们 已 经 接触 
过 了 ， 而 MessageQueue 和 Looper 对 于 你 来 说 还 是 全 新 的 概念 ， 下 面 我 惑 对 
这 4 个 部 分 进行 一 下 简要 的 介绍 。 


01. Message 


Message 征 在 线程 之 间 传 递 的 消息 ， 它 可 以 在 内 部 携带 少量 的 信息 ， 用 
于 在 不 同 线程 之 间 交 换 数 据 。 上 一 小 市 中 我 们 使 用 到 了 Message 的 what 
字段 ， 除 此 之 外 还 可 以 使 用 argl 和 arg2 字段 来 携 市 一 些 整 型 数据 ， 使 
用 obj 字段 携带 一 个 object 对 象 。 


02. Handler 


Handler 顾 名 思 义 也 就 是 处 理 者 的 意思 ， 它 主要 是 用 于 发 送 和 处 理 消息 
的 。 发 送 消 息 一 般 是 使 用 Handler 的 sendMessage() 方法 ， 而 发 出 的 消息 
经 过 一 系列 地 轧 转 处 理 后 ， 最 终 会 传递 到 HandlerHihandleMessage() 方 
人 靶 由 史 


03. MessageQueue 


MessageQueue 是 消 居 队 了 | 的 意思 ， Ee 于 存放 所 有 通过 Handler 发 
送 的 消息 。 这 部 分 消息 会 一 直 存 在 于 消息 队列 中 ， 等 待 被 处 理 。 每 个 
线程 中 只 会 有 一 个 MessageQueue 对 象 。 


04. Looper 


Looper 是 每 个 线程 中 的 MessageQueue 的 管家 ， 调 用 Looper 的 1oop() 方 

法 后 ， 就 会 进入 到 一 个 无 限 循环 当中 ， 然 后 每 当 发 现 MessageQueue 中 

存在 一 条 消息 ， 就 会 将 它 取 出 ， 并 传递 到 HandlerHJhandleMessage() 方 
法 中 。 每 个 线程 中 也 只 会 有 一 个 Looper 对 象 。 


了 解 了 Message、Handler、MessageQueue 以 及 Looper 的 基本 概念 后 ， 我 们 再 
来 把 异步 消息 处 理 的 整个 流程 梳理 一 遍 。 首先 需 要 在 主线 程 当 中 创建 一 个 
Handler 对 象 ， 并 重 写 handleMessage( ) 方法 。 然 后 当 子 线程 中 需要 进行 UI 
操作 时 ， 惑 创建 一 个 Message 对 象 ， 并 通过 Handler 将 这 条 消息 发 送出 去 。 之 
后 这 条 消息 会 被 添加 到 MessageQueue 的 队列 中 等 待 被 处 理 ， 而 Looper 刚 会 
一 直 壬 试 从 MessageQueue 中 取出 每 处 理 消 忆 ， 最 后 分 发 回 Handler 的 
handleMessage( ) 方法 中 。 由 于 Handler 是 在 主线 程 中 创建 的 ， 所 以 此 时 
handleMessage( ) 方法 中 的 代码 也 会 在 主线 程 中 运行 ， 于 是 我 们 在 这 里 就 可 
以 安心 地 进行 UI 操作 了 。 整 个 异步 消息 处 理 机 制 的 流程 示意 图 如 图 10.4 所 
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图 10.4 异步 消息 处 理 机 制 流程 示意 图 


一 条 Message 经 过 这 样 一 个 流程 的 加 轩 调用 后 ， 也 束 从 子 线程 进入 到 了 主线 
程 ， 从 不 能 更 新 UI 变 成 了 可 以 更 新 UI， 整 个 异步 消息 处 理 的 核心 思想 也 就 
征 如 此 。 


而 我 们 在 9.2.1 小 节 中 使 用 到 的 runonuiThread() 方法 其 实 就 是 一 个 异步 消息 
处 理 机 制 的 接口 封装 ， 它 虽然 表面 上 看 起 来 用 法 更 为 简单 ， 但 其 实 背 后 的 
实现 原理 和 图 10.4 中 的 描述 是 一 模 一 样 的 。 


10.2.4 ”使 用 AsyncTask 


不 过 为 了 更 加 方便 我 们 在 子 线程 中 对 UI 进行 操作 ，Android 还 提供 了 另外 一 
些 好 用 的 工具 ， 比 如 AsyncTask。 借 助 AsyncTask， 即 使 你 对 异步 消息 处 理 机 
制 完 全 不 了 解 ， 也 可 以 十 分 简单 地 从 子 线程 切换 到 主线 程 。 当 然 ， 
AsyncTask 背 后 的 实现 原理 也 是 基于 异步 消息 处 理 机 制 的 ， 只 是 Android 帮 有 我 
们 做 了 很 好 的 封装 而 已 。 


首先 来 看 一 下 AsyncTask 的 基本 用 法 ， 由 于 AsyncTask 是 一 个 抽象 类 ， 所 以 如 
果 我 们 想 使 用 它 ， 束 必须 要 创建 一 个 子 类 去 继承 它 。 在 继承 时 我 们 可 以 为 


AsyncTask 类 指定 3 个 泛 型 参数 ， 这 3 个 参数 的 用 途 如 下 。 


。 Params 。 在 执行 AsyncTask 时 需要 传 入 的 参数 ， 可 用 于 在 后 台 任 务 中 使 
用 。 


。 Progress 。 后 台 任 务 执行 时 ， 如 果 需 要 在 界面 上 显示 当前 的 进度 ， 则 
使 用 这 里 指定 的 泛 型 作为 进度 单位 。 


。 Result 。 当 任务 执行 完毕 后 ， 如 有 果 需 要 对 结果 进行 返回 ， 则 使 用 这 里 
指定 的 泛 型 作为 返回 值 关 型 。 


因此 ， 一 个 最 简单 的 自 定义 AsyncTask 就 可 以 写成 如 下 方式 : 


class DownloadTask extends AsyncTask<Void, Integer, Boolean> { 


} 


这 里 我 们 把 AsyncTask 的 第 一 个 泛 型 参数 指定 为 void ， 表 示 在 执行 
AsyncTask 的 时 候 不 需要 传 入 参数 给 后 台 任 务 。 第 二 个 泛 型 参数 指定 为 
Integer ， 表 示 使 用 整 型 数据 来 作为 进度 显示 单位 。 第 三 个 泛 型 参数 指定 为 
Boolean ， 则 表示 使 用 布尔 型 数据 来 反馈 执行 结果 。 


当然 ， 目 前 我 们 目 定 义 的 DownloadTask 还 是 一 个 空 任务 ， 并 不 能 进行 任何 
实际 的 操作 ， 我 们 还 需要 去 重 写 AsyncTask 中 的 几 个 方法 才能 完成 对 任务 的 
定制 。 经 常 需要 去 重 写 的 方法 有 以 下 4 个 。 


01. onPreExecute() 


这 个 方法 会 在 后 台 任务 开始 执行 之 前 调用 ， 用 于 进行 一 些 界 面 上 的 初 
台 化 操作 ， 比 如 显示 一 个 进度 条 对 话 框 等 。 
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. doInBackground(Params...) 


这 个 方法 中 的 所 有 代码 都 会 在 子 线程 中 运行 ， 我 们 应 该 在 这 里 去 处 理 
所 有 的 耗 时 任务 。 任 务 一 旦 完成 就 可 以 通过 return 语句 来 将 任务 的 执 
行 结果 返回 ， 如 果 AsyncTask 的 第 三 个 泛 型 参数 指定 的 是 void ， 就 可 以 
不 返回 任务 执行 结果 。 注 意 ， 在 这 个 方法 中 是 不 可 以 进行 UI 操作 的 ， 
如 果 需 要 更 新 UI 元 素 ， 比 如 说 反馈 当前 任务 的 执行 进度 ， 可 以 调用 
publishProgress (Progress...) 方法 来 完成 2 


03. onProgressUpdate(Progress...) 


当 在 后 人 台 任 务 中 调用 了 publishProgress(Progress...) 方法 后 ， 
onProgressUpdate (Progress...) 方法 就 会 很 快 被 调用 ， 该 方法 中 携带 
的 参数 就 是 在 后 台 任 务 中 传递 过 来 的 。 在 这 个 方法 中 可 以 对 UI 进行 操 
作 ， 利 用 参数 中 的 数值 就 可 以 对 界面 元 素 进行 相应 的 更 新 。 


04. onPostExecute (Result) 


当 后 台 任 务 执行 完毕 并 通过 return 语句 进行 返回 时 ， 这 个 方法 就 很 快 
会 被 调用 。 返 回 的 数据 会 作为 参数 传递 到 此 方法 中 ， 可 以 利用 返回 的 
数据 来 进行 一 些 UI 操 作 ， 比 如 说 提醒 任务 执行 的 结 采 ， 以 及 关闭 挥 进 
度 条 对 话 框 等 。 


因此 ， 一 个 比较 完整 的 自 定义 AsyncTask 就 可 以 写成 如 下 方式 : 


class DownloadTask extends AsyncTask<Void, Integer, Boolean> { 


Q@Override 
protected void onPreExecute() { 
progressDialog.show(); // 显示 进度 对 话 术 


TH 


QOverride 
protected Boolean doInBackground(Void... params) { 
try { 
while (true) { 
int downloadPercent = doDownload(); // 这 是 一 个 虚构 的 方法 
publishProgress(downloadPercent); 
if (downloadPercent >= 100) { 
break; 
} 
} 


} catch (Exception e) { 
return false; 


上 
return true,; 
} 
Q@Override 
protected void onProgressUpdate(Integer... values) { 
// 在 这 里 更 新 下 载 进度 
progressDialog.setMessage("Downloaded " + values[0] + "%"); 
QOverride 


protected void onPostExecute(Boolean result) { 
progressDialog.dismiss(); // 关闭 进度 对 话 框 
// 在 这 里 提示 下 载 结果 
if (result) { 
Toast.makeText(context, "Download succeeded", Toast.LENGTH_SHORT).show(); 
} else { 
Toast.makeText(context, " Download failed", Toast.LENGTH_SHORT).show(); 
} 


HI 


| 
在 这 个 DownloadTask 中 ， 我 们 在 doInBackground() 方法 里 去 执行 具体 的 下 
载 任 务 。 这 个 方法 里 的 代码 都 是 在 子 线程 中 运行 的 ， 因 而 不 会 影响 到 主线 
程 的 运行 。 注 意 这 里 虚构 了 一 个 dopownload() 方法 ， 这 个 方法 用 于 计算 当 
前 的 下 载 进度 并 返回 ， 我 们 假设 这 个 方法 已 经 存在 了 。 在 得 到 了 当前 的 下 
载 进 度 后 ， 下 面 就 该 考虑 如 何 把 它 显 示 到 界面 上 了 ， 由 于 doInBackground() 
方法 是 在 子 线程 中 运行 的 ， 在 这 里 肯定 不 能 进行 UI 操作 ， 所 以 我 们 可 以 调 
用 publishprogress() 方法 并 将 当前 的 下 载 进 度 传 进 来 ， 这 样 
onProgressUpdate( ) 方法 就 会 很 快 被 调用 ， 在 这 里 就 可 以 进行 UI 探 作 了 。 
当下 载 完 成 后 ，doInBackground() 方法 会 返回 一 个 布尔 型 变量 ， 这 样 
onPostExecute() 方法 束 会 很 快 被 调用 ， 这 个 方法 也 是 在 主线 程 中 运行 的 。 
然后 在 这 里 我 们 会 根据 下 载 的 结果 来 弹出 相应 的 Toast 提 示 ， 从 而 完成 整个 
DownloadTask 任 务 。 


简单 来 说 ， 使 用 AsyncTask 的 诀窍 承 是 ， 在 doInBackground( ) 方法 中 执行 具 
体 的 耗 时 任务 ， 在 onpProgressupdate( ) 方法 中 进行 UI 操作 ， 在 
onPostExecute() 方法 中 执行 一 些 任务 的 收尾 工作 。 


如 果 想 要 启动 这 个 任务 ， 只 需 编 写 以 下 代码 即 可 : 


new DownloadTask().execute(); 


以 上 束 是 AsyncTask 的 基本 用 法 ， 怎 么 样 ， 是 不 是 感觉 简单 方便 了 许多 ? 我 
们 并 不 需要 去 考虑 什么 异步 消息 处 理 机 制 ， 也 不 需要 专门 使 用 一 个 Handler 
来 发 送 和 接收 消息 ， 只 需要 调用 一 下 publishprogress() 方法 ， 就 可 以 轻松 
地 从 子 线程 切换 到 UI 线程 了 。 


在 本 章 的 最 佳 实践 环节 ， 我 们 会 对 下 载 这 个 功能 进行 完整 的 实现 。 


10.3 ”服务 的 基本 用 法 


了 解 了 Android 多 线程 编程 的 技术 之 后 ， 下 面 就 让 我 们 进入 到 本 章 的 正题 ， 
开始 对 服务 的 相关 内 容 进行 学 习 。 作 为 Android 四 大 组 件 之 一 ， 服 务 也 少 不 


了 有 很 多 非 稼 重要 的 知识 点 ， 那 我 们 目 热 要 从 最 基本 的 用 法 开始 学 习 3 了。 


10.3.1 ”定义 一 个 服务 


自 先 看 一 下 如 何在 项 目 中 定义 一 个 服务 。 新 建 一 个 ServiceTest 项 目 ， 然 后 右 
击 com.example.servicetest 一 New 一 Service ~ Service， 会 弹出 如 图 10.5 所 示 的 
窗口 。 
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图 10.5 创建 服务 的 窗口 


可 以 看 到 ， 这 里 我 们 将 服务 命名 为 MyService，Exported 属性 表示 是 否 允 许 
除了 当前 程序 之 外 的 其 他 程序 访问 这 个 服务 ，Enabled 属性 表示 是 否 启用 这 
个 服务 。 将 两 个 属性 都 勾 中 ， 点 击 Finish 完 成 创建 。 


现在 观察 MyService 中 的 代码 ， 如 下 所 示 : 


public class MyService extends Service { 


public MyService() { 
} 


Q@Override 
public IBinder onBind(Intent intent) { 
throw new UnsupportedOperationException("Not yet implemented"); 


} 


可 以 看 到 ，Myservice 是 继承 自 service 类 的 ， 说 明 这 是 一 个 服务 。 目 前 
MyService 中 可 以 算是 空空 如 也 ， 但 有 一 个 onBind() 方法 特别 醒目 。 这 个 方 
法 是 Service 中 唯一 的 一 个 抽象 方法 ， 所 以 必须 要 在 子 类 里 实现 。 我 们 会 在 
后 面 的 小 下 中 使 用 到 onBind() 方法 ， 目 前 可 以 暂时 将 它 忽 略 掉 。 


既然 是 定义 一 个 服务 ， 目 然 应 该 在 服务 中 去 处 理 一 些 事情 了 ， 那 处 理事 情 
的 逻辑 应 该 写 在 哪里 呢 ? 这 时 吏 可 以 重 写 Service 中 的 鸡 外 一 些 方法 了 ， 如 
Th 


public class MyService extends Service { 


QOverride 
public void onCreate() { 
super .onCreate(); 


} 


QOverride 
public int onStartCcommand(Intent intent, int flags, int StartId) { 


return super.onstartCcommand(intent, flags, startId); 


QOverride 
public void onDestroy() { 
super .onDestroy(); 


可 以 看 到 ， 这 里 我 们 又 重 写 了 oncreate() 、onstartCcommand( ) 和 
onDestroy() 这 3 个 方法 ， 它 们 是 每 个 服务 中 最 常用 到 的 3 个 方法 了 。 其 中 
oncCreate() 方法 会 在 服务 创建 的 时 候 调用 ，onstartcommand() 方法 会 在 每 
次 服务 启动 的 时 候 调 用 ，onpestroy() 方法 会 在 服务 销毁 的 时 候 调 用 。 


通常 情况 下 ， 如 果 我 们 硕 望 服务 一 旦 启动 区 立刻 去 执行 某 个 动作 ， 残 可 以 
将 逻辑 写 在 onstartcommand() 方法 里 。 而 当 服 务 销毁 时 ， 我 们 又 应 该 在 
onDestroy() 方法 中 去 回收 那些 不 再 使 用 的 资源 。 


用 需要 注意 ， 每 一 个 服务 都 需要 在 AndroidManifest,xml 文 件 中 进行 注册 才 

能 生效 ， 不 知道 你 有 没有 发 现 ， 这 是 Android 四 大 组 件 共 有 的 特点 。 不 过 相 
信 你 已 经 狂 到 了 ， 镶 能 的 Android J 自动 帮 有 我 们 将 这 一 步 完 成 了 。 
打开 AndroidManifest.xzml 文 件 瞧 一 瞧 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.servicetest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<service 
android:name=" .MyService" 
android:enabled="true" 
android:exported="true"> 
</service> 
</application> 


</manifest> 


这 样 的 话 ， 束 已 经 将 一 个 服务 完全 定义 好 了 。 


10.3.2 ”启动 和 停止 服务 

定义 好 了 服务 之 后 ， 接 下 来 就 应 该 考虑 如 何 去 局 动 以 及 停止 这 个 服务 。 局 
动 和 停止 的 方法 当然 你 也 不 会 陌生 ， 主 要 是 借助 Intent 来 实现 的 ， 下 面 就 让 
我 们 在 ServiceTest 项 目 中 尝试 去 启动 以 及 停止 MyService 这 个 服务 。 


首先 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/start_service" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Start Service" /> 


<Button 
android:id="@+id/stop_service" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Stop Service" /> 


</LinearLayout> 


ee 局 文件 中 加 入 了 两 个 按钮 ， 分 别 是 用 于 局 动 服务 和 停止 服务 


然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
Button startService = (Button) findViewById(R.id,.start_ service); 
Button stopService = (Button) findViewById(R.id,.stop_ service); 
startService.setOonClickListener(this); 
stopService.setOonclickListener(this); 


} 


QOverride 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.start_service: 
Intent startIintent = new Intent(this, MyService.class); 
startService(startIntent); // 启动 服务 
break; 
case R.id.stop_service: 
Intent stopIntent = new Intent(this, MyService.class); 
stopService(stopIntent); // 停止 服务 
break; 
default: 
break; 


可 以 看 到 ， 这 里 在 oncreate() 方法 中 分 别 获取 到 了 Start Service 按 钮 和 Stop 
Service 按 钮 的 实例 ， 并 给 它们 注册 了 点 击 事件 。 然 后 在 Start Service 按 钮 的 
点 击 事件 里 ， 我 们 构建 出 J 广 Intent 对 象 ， 并 调用 startservice() 方法 
来 启动 MyService 这 个 服务 。 在 Stop Serivce 按 钮 的 点 击 事 件 里 ， 我 们 同样 构 
建 出 了 一 个 Intent 对 象 ， 并 调用 stopservice() 方法 来 停止 MyService 这 个 
服务 。 startService() 和 stopService() 方法 都 是 定义 在 context 类 中 的 ， 


所 以 我 们 在 活动 里 可 以 直接 调用 这 两 个 方法 。 注 意 ， 这 里 完全 是 由 活动 来 
决定 服务 何 时 停止 的 ， 如 果 没 有 点 击 Stop Service 按 钮 ， 服 务 就 会 一 直 处 于 
运行 状态 。 那 服务 有 没有 什么 办 法 让 上 自已 停止 只 需要 
在 MyService 的 任何 一 个 位 置 调 用 stopself() 方法 就 能 让 这 个 服务 停止 下 来 


那么 接 下 来 又 有 一 个 问题 需要 思考 了 ， 我 们 如 何 才能 证 实 服务 已 经 成 功 启 
动 或 者 停止 了 呢 ? 最 简单 的 方法 就 是 在 MyService 的 几 个 方法 中 加 入 打印 日 
志 ， 如 下 所 示 : 


public class MyService extends Service { 


Q@Override 
public void onCreate() { 
super .onCreate( ) ， 
Log.d("MyService", "onCreate executed"); 


Q@Override 

public int onStartCommand(Intent intent, int flags, int startId) { 
Log.d("MyService", "onStartCommand executed"); 
return super.onstartCcommand(intent, flags, startId); 


} 


Q@Override 
public void onDestroy() { 
super .onDestroy(); 
Log.d("MyService", "onDestroy executed"); 


现在 可 以 运行 一 下 程序 来 进行 测试 了 ， 程 序 的 主 界面 如 图 10.6 所 示 。 
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图 10.6 ”ServiceTest 的 主 界面 
点 击 一 下 Start Service 按 钮 ， 观 察 logcat 中 的 打印 日 志 ， 如 图 10.7 所 示 。 
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com. example. servicetest D/MyService: onCreate executed 


com. example. servicetest D/MyService: onStartCommand executed 


图 10.7 启动 服务 时 的 打印 日 志 


MyService 中 的 oncreate() 和 onstartcommand() 方法 都 执行 了 ， 说 明 这 个 服 
务 确实 已 经 局 动 成 功 了 ， 并 且 你 还 可 以 在 Settings ~ Developer 
options 一 Running services 中 找到 它 ， 如 图 10.8 所 示 。 
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€ Running serv..， SHOW CACHED PROCESSES 


Device memory 


凋 


App RAM usage 


Settings ;ME 
1 process and 0 services 


ServiceTest 11 MB 
1 process arw 1 service 6:4 


i Play services 5 M 
] Cess ard 5 


Google Play Services 27 MB 
1] process and 1 service Ta 


Google App 27 MB 
process and 1 service 20:01 


Android Keyboard (AOSP) 8.3 MB 
1 process and 1 servi 0 


了 


图 10.8 ”正在 运行 的 服务 列表 


然后 再 点 击 一 下 Stop Service 按 钮 ， 观 察 logcat 中 的 打印 日 志 ， 如 图 10.9 所 
不 o 


Verbose 图 (IQr 


com. example. servicetest D/MyService: onDestroy executed 


图 10.9 停止 服务 时 的 打印 日 志 
由 此 证 明 ，MyService 确 实 已 经 成 功 停止 下 来 了 。 


话说 回来 ， 虽 然 我 们 已 经 学 会 了 启动 服务 以 及 停止 服务 的 方法 ， 不 知道 你 
心里 现在 有 没有 一 个 疑惑 ， 那 束 是 oncreate() 方法 和 onstartcommand() 方 


法 到 的 有 什么 区 别 呢 ?因为 刚刚 点 击 Start Service 按 钮 后 两 个 方法 都 执行 
了 了。 


其 实 oncreate( ) 方法 是 在 服务 第 一 次 创建 的 时 候 调 用 的 ， 而 
onstartcommand() 方法 则 在 每 次 启动 服务 的 时 候 都 会 调用 ， 由 于 刚才 我 们 
是 第 一 次 点 击 Start Service 按 钮 ， 服 务 此 时 还 未 创建 过 ， 所 以 两 个 方法 都 会 
执行 ， 之 后 如 果 你 再 连续 多 点 击 几 次 Start Service 按 钮 ， 你 就 会 发 现 只 有 
onStartCcommand ( ) 方法 可 以 得 到 执行 了 。 


10.3.3 ”活动 和 服务 进行 通信 


上 一 小 节 中 我 们 学 习 了 启动 和 停止 服务 的 方法 ， 不 知道 你 有 没有 发 现 ， 虽 
然 服务 是 在 活动 里 局 动 的 ， 但 在 启动 了 服务 之 后 ， 活 动 与 服务 基本 束 没 有 
什么 关系 了 。 确 实 如 此 ， 我 们 在 活动 里 调用 了 startservice() 方法 来 局 动 
MyService 这 个 服务 ， 然后 MyServicebyJonCreate( ) 和 onstartcommand( ) 方法 
融会 得 到 执行 。 之 后 服务 会 一 直 处 于 运行 状态 ， 但 具体 运行 的 是 什么 还 
活动 就 控制 不 了 了 “。 这 就 类 似 于 活动 通知 了 服务 一 下 ，“ 你 可 以 启动 

”然后 服务 瓯 去 忙 目 己 的 事情 了 ， 但 活动 并 不 知道 服务 到 底 去 做 了 什么 
吉本 以 及 完成 得 如 何 。 


那么 有 没有 什么 办 法 能 让 活动 和 服务 的 关系 更 紧密 一 些 呢 ? 例如 在 活动 中 
指挥 服务 去 和 干什么， 服务 就 去 干什么 。 当 然 可 以 ， 这 就 需要 借助 我 们 刚刚 
忽略 的 onBind() 方法 了 。 


比如 说 ， 目 前 我 们 希望 在 MyService 里 提供 一 个 下 载 功 能 ， 然 后 在 活动 中 可 
以 决定 何 时 开始 下 载 ， 以 及 随时 查看 下 载 进度 。 实 现 这 个 功能 的 思路 是 创 
建 一 个 专门 的 Binder 对 象 来 对 下 载 功能 进行 管理 ， 修 改 MyService 中 的 代 

码 ， 如 下 所 示 : 


public class MyService extends Service { 


private DownloadBinder mBinder = new DownloadBinder(); 
class DownloadBinder extends Binder { 


public void startDownload() { 
Log.d("MyService", "startDownload executed"); 


public int getProgress() 
Log.d("MyService", "getProgress executed"); 
return 0; 


} 


Q@Override 
public IBinder onBind(Intent intent) { 
return mBinder; 


可 以 看 到 这 里 我 们 新 建 了 一 人 1 DownloadBinder 类 ， 并 让 它 继承 自 Binder 
， 然 后 在 它 的 内 部 提供 了 开始 下 载 以 及 查看 下 载 进 度 的 方法 。 当然 这 只 是 
两 个 模拟 方法 ， 并 没有 实现 真正 的 功能 ， 我 们 在 这 两 个 方法 中 分 别 打印 了 
二 二 二 人 


接着 ， 在 MyService 中 创建 了 DownloadBinder 的 实例 ， 然 然后 在 onBind() 方法 
里 返回 了 这 个 实例 ， 这 样 MyService 中 的 工作 就 全 部 完成 了 。 


站 面 就 要 看 一 看 ， 在 活动 中 如 何 去 调 用 服务 里 的 这 些 方法 了 。 首 先 需 要 在 
布局 文件 里 新 增 两 个 按钮 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/bind_service" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Bind Service" /> 


<Button 
android:id="@+id/unbind_service" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Unbind Service" /> 


</LinearLayout> 


这 两 个 按钮 分 别 是 用 于 绑 定 服务 和 取消 绑 定 服务 的 ， 那 到 底 谁 需要 去 和 服 
务 绑 定 呢 ? 当然 就 是 活动 了 。 当 一 个 活动 和 服务 绑 定 了 之 后 ， 就 可 以 调用 
该 服务 里 的 Binder 提供 的 方法 了 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private MyService.DownloadBinder downloadBinder 
private ServiceConnection connection = new ServiceConnection() { 


Q@Override 
public void onServiceDisconnected(ComponentName name) { 


} 


Q@Override 
public void onServiceConnected(ComponentName name, IBinder service) { 
downloadBinder = (MyService.DownloadBinder) service; 
downloadBinder .startDownload( ) ， 
downloadBinder .getProgress(); 
} 
}; 


QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedIinstanceState); 
setcontentView(R.1layout.activity_main); 


Button bindService = (Button) findViewById(R.id.bind service); 
Button unbindService = (Button) findViewById(R.id.unbind_service); 
bindService.setonclickListener(this); 
unbindService.setOonclickListener(this); 


} 


Q@Override 
public void onClick(View v) { 
Switch (v.getId()) { 


case R.id.bind_service: 
Intent bindIntent = new Intent(this, MyService.class); 
bindService(bindIntent，connection，BIND_AUTO_CREATE);， // 绑 定 服务 
break; 

Case R.id.unbind_service: 
unbindService(connection); // 解 绑 服务 
break; 

default: 
break; 


这 里 我 们 首先 创建 了 一 个 serviceconnection 的 匿名 类 ， 在 里 面 重 写 了 
onServiceConnected() 方法 和 onServiceDisconnected() 方法 ， 这 两 个 方法 


分 别 会 在 活动 与 服务 成 功 绑 定 以 及 活动 与 服务 的 连接 断 开 的 时 候 调 用 。 在 
onServiceConnected() 为; 震中 ， 我 们 义 通过 同 下 加 型 得 到 ] DownloadBinder 
的 实例 ， 有 了 这 个 实例 ， 活 动 和 服务 之 间 的 关系 就 变 得 非常 紧密 了 。 现 在 
我 们 可 以 在 活动 中 根据 具体 的 场景 来 调用 pownloadBinder 中 的 任何 public 
方法 ， 即 实现 了 指挥 服务 干什么 服务 就 去 干什么 的 功能 。 这 里 仍然 只 是 做 
了 个 简单 的 测试 ， 在 onserviceconnected() 方法 中 调用 了 DownloadBinder 的 
startDownload() 和 getProgress() 方法 。 


当然 ， 现 在 活动 和 服务 其 实 还 没 进行 绑 定 昵 ， 这 个 功能 是 在 Bind Service 按 
钮 的 点 击 事件 里 完成 的 。 可 以 看 到 ， 这 里 我 们 仍然 是 构建 出 了 一 个 Intent 
对 象 ， 然 后 调用 bindservice() 方法 将 MainActivity 和 MyService 进 行 绑 定 。 
bindService() 方法 接收 3 个 参数 ， 第 一 个 参数 就 是 刚刚 构建 出 的 Intent 对 
象 ， 第 二 个 参数 是 前 面 创建 出 的 ServiceConnection 的 实例 ， 第 三 个 参数 则 是 
一 个 标志 位 ， 这 里 传 入 BIND_AUTO_CREATE 表示 在 活动 和 服务 进行 绑 定 后 自 
动 创建 服务 。 这 会 使 得 MyService 中 的 oncreate() 方法 得 到 执行 ， 但 
onStartCcommand ( ) 方法 不 会 执行 。 

然后 如 果 我 们 想 解 除 活 动 和 服务 之 间 的 绑 定 该 怎么 办 呢 ? 调用 一 下 
unbindservice() 方法 就 可 以 了 ， 这 也 是 Unbind Service 按 钮 的 点 击 事件 里 实 
现 的 功能 。 


现在 让 我 们 重新 运行 一 下 程序 吧 ， 界 面 如 图 10.10 所 示 。 
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ServiceTest 


START SERVICE 


STOP SERVICE 


BIND SERVICE 


UNBIND SERVICE 


图 10.10 ”ServiceTest 新 的 主 界面 


点 击 一 下 Bind Service 按 钮 ， 然 后 观察 logcat 中 的 打印 日 志 ， 如 图 10.11 所 示 。 


Verbose 图 ( Dr 


com. example. servicetest D/MyService: onCreate executed 


com. example. servicetest D/MyService: startDownload executed 


com. example. servicetest D/MyService: getProgress executed 


图 10.11 比 定 服务 时 的 打印 日 志 


可 以 看 人 到， 首先 是 MyService 的 oncreate( ) 方法 得 到 了 执行 ， 然 后 
startDownload() getprogress() 方法 都 得 到 了 执行 ， 说 明 我 们 确实 已 经 
在 活动 里 成 功 调用 了 服务 里 提供 的 方法 了 。 


另外 需要 注意 ， 任 何 一 个 服务 在 整个 应 用 程序 范围 内 都 是 通用 的 ， 即 
MyService 不 仅 可 以 和 MainActivity 绑 定 ， 还 可 以 和 任何 一 个 其 他 的 活动 进行 
绑 定 ， 而 且 在 绑 定 完成 后 它们 都 可 以 获取 到 相同 的 DownloadBinder 实 例 。 


10.4 服务 的 生命 周期 


之 前 我 们 学 习 过 了 活动 以 及 雁 族 的 生命 周期 。 类 似 地 ， 服 务 也 有 目 己 的 生 
命 周 期 ， 前 面 我 们 使 用 到 的 oncreate() 、 onStartCcommand( ) 、 onBind() 和 
onDestroy() 等 方法 都 是 在 服务 的 生命 周期 内 可 能 回调 的 方法 。 


一 旦 在 项 目 的 任何 位 置 调用 了 Context 的 startService( ) 方法 ， 相应 的 服务 
就 会 启动 起 来 ， 并 回调 onstartcommand( ) 方法 。 如 果 这 个 服务 之 前 还 没有 
创建 过 ，oncreate() 方法 会 和 完 于 onstartcommand() 方法 执行 。 服 务 局 动 了 
之 后 会 一 直 保 持 运行 状态 ， 直到 stopservice() 或 stopSelf() 方法 被 调用 。 
注意 ， 虽 然 每 调用 一 次 startservice() 方法 ，onstartcommand() 就 会 执行 
AR， 但 实际 上 每 个 服务 都 公会 存在 一 个 实例 。 所 以 不 管 你 调用 了 多 少 次 
startServicel() Ea 个 只 需 调 用 次 stopService()) 或 stopSelf() 方法 ， 服 
务 就 会 停止 下 来 了 。 


另外 ， 还 可 以 调用 Context 的 bindservice() 来 获取 一 个 服务 的 持久 连接 ， 这 
时 驳 会 回调 服务 中 的 onBind() 方法 。 类 似 地 ， 如 采 这 个 服务 之 前 还 没有 创 
建 过 ，oncreate( ) 方法 会 先 于 onBind() 方法 执行 。 之 后 ， 调 用 方 可 以 获取 
到 onBind() 方法 里 返回 的 IBinder 对 象 的 实例 ， 这 样 丈 能 目 由 地 和 服务 进行 


只 要 调用 方 和 服务 之 间 的 连接 没有 断 开 ， 服 务 束 会 一 直 保持 运行 


当 调 用 了 startservice() 方法 后 ， 又 去 调用 stopservice() 方法 ， 这 时 服务 
中 的 onpestroy() 方法 驳 会 执行 ， 表 示 服 务 已 经 销毁 了 。 类 似 地 ， 当 调用 了 
bindService( ) 方法 后 ， 又 去 调用 unbindservice() pi onDestroy() 方法 
也 会 执行 ， 这 两 种 情况 都 很 好 理解 。 但 是 需要 注意 ， 我 们 是 完全 有 可 能 对 
一 个 服务 既 调 用 了 startservice() 方法 ， 又 调用 了 bindservice() 方法 的 ， 
这 种 情况 下 该 如 何 才能 让 服务 销毁 掉 呢 ? ee 一 个 服 
务 只 要 被 局 动 或 者 被 绑 定 了 之 后 ， 融 会 一 直 处 于 运行 状态 ， 必 须要 让 以 上 
两 种 条 件 同时 不 满足 ， 服 务 才 外 被 销 贤 。 所 以 、 这 种 情况 下 要 同时 调用 
stopService() 和 unbindservice() 为 二， onDestroy() 方法 才 会 执行 。 


这 样 你 就 已 经 把 服务 的 生命 周期 完整 地 走 了 一 人 遍 。 


10.5 ”服务 的 更 多 技巧 


以 上 所 学 的 都 是 关于 服务 最 基本 的 一 些 用 法 和 概念 ， 当 然 也 是 最 常用 的 。 
不 过 ， 仪 仅 满 足 于 此 显然 是 不 够 的 ， 关 于 服务 的 更 多 融 级 使 用 技巧 还 在 等 
着 我 们 呢 ， 下 面 就 赶快 去 看 一 看 吧 。 


10.5.1 使 用 前 台 服 务 


服务 儿 乎 都 是 在 后 台 运 行 的 ， 一 直 以 来 它 都 是 默 稚 地 做 着 泣 兰 的 工作 。 但 
征服 务 的 系统 优 移 级 还 是 比较 低 的 ， 当 系统 出 现 内 存 不 足 的 情况 时 ， 残 有 
可 能 会 回收 挥 正在 后 台 运 行 的 服务 。 如 有 果 你 和 硕 望 服务 可 以 一 直 保持 运行 状 
态 ， 而 不 会 由 于 系统 内 存 不 足 的 原因 导致 被 回收 ， 融 可 以 考虑 使 用 前 台 服 

务 。 前 台 服务 和 普通 服务 最 大 的 区 别 就 在 于 ， 它 会 一 直 有 一 个 正在 运行 的 
图 标 在 系统 的 状态 栏 显示 ， 下 拉 状 态 栏 后 可 以 看 到 更 加 详细 的 信息 ， 非 币 
类 似 于 通知 的 效果 。 当 然 有 时 候 你 也 可 能 不 仅仅 是 为 了 防止 服务 被 回收 挥 
才 使 用 前 合 服务 的 ， 有 些 项 目 由 于 特殊 的 需求 会 要 求 必须 使 用 前 台 服务 ， 
比如 说 彩云 天 气 这 球 天 气 预 报应 用 ， 它 的 服务 在 后 台 更 新 天 气 数据 的 同 
时 ， 还 会 在 系统 状态 栏 一 直 显 示 当 前 的 天 气 信息 ， 如 图 10.12 所 示 。 


19*" 阴 
未 来 两 小 时 不 会 下 雨 ， 放 心 出 门 吧 


图 10.12 彩云 天 气 的 前 台 服 务 效果 


那么 我 们 就 来 看 一 下 如 何 才能 创建 一 个 前 台 服 务 吧 ， 其 实 并 不 复杂 ， 修 改 
MyService 中 的 代码 ， 如 下 所 示 : 


public class MyService extends Service { 


Q@Override 
public void onCreate() { 
super .onCreate( ) ， 
Log.d("MyService", "onCreate executed"); 
Intent intent = new Intent(this, MainActivity.class); 
PendingIntent pi = PendingIntent.getActivity(this, 0, intent, 0); 
Notification notification = new NotificationCompat.Builder(this) 
.SetCcontentTitle("This is content title") 
.SetContentText("This is content text") 
.Setwhen(System.currentTimeMil]lis()) 
.SetSsmallIcon(R.mipmap.ic_launcher) 


.SetLargeIcon(BitmapFactory.decodeResource(getResources(), 
R.mipmap.ic_launcher)) 
.SetContentIntent(pI) 
.build()， 
startForeground(1, notification); 


可 以 看 到 ， 这 只 是 修改 了 oncreate() 方法 中 的 代码 ， 相 信 这 部 分 代码 你 
会 非常 眼熟 。 os 这 就 是 我 们 在 第 8 章 中 学 习 的 创建 通知 的 方法 。 只 不 过 
这 次 在 构建 出 Notification 对 象 后 并 没有 使 用 NotificationManager 来 将 通知 
显示 出 来 ， 而 是 调用 了 startForeground( ) 方法 。 这 个 方法 接收 两 个 参数 ， 
第 一 个 参数 是 通知 的 id， 类 似 于 notify() 方法 的 第 一 个 参数 ， 第 二 个 参数 则 
是 构建 出 的 Notification 对 象 。 调 用 startForeground() 方法 后 就 会 让 
MyService 变 成 一 个 上 前台 服务 ， 并 在 系统 状态 栏 显示 出 来 。 


现在 重新 运行 一 下 程序 ， 并 点 击 Start Service 或 Bind Service 按 钮 ，MyService 
融会 以 前 台 服 务 的 模式 司 动 了 ， 并 且 在 系统 状态 栏 会 显示 一 个 通知 图 标 ， 
下 拉 状 态 栏 后 可 以 看 到 该 通知 的 详细 内 容 ， 如 图 10.13 所 示 8 


一 This is content title 
Nis is coNtent text 


图 10.13 前 台 服 务 的 状态 栏 效 果 


前 台 服 务 的 用 法 就 这 么 简单 ， 只 要 你 在 第 8 章 中 将 通知 的 用 法 掌握 好 了 ， 学 
习 本 市 的 知识 一 定 会 特别 轻松 。 


10.5.2 ”使 用 IntentService 


话说 回来 ， 在 本 章 一 开始 的 时 候 我 们 就 已 经 知道 ， 服 务 中 的 代码 都 是 默认 
运行 在 主线 程 当中 的 ， 如 果 直 接 在 服务 里 去 处 理 一 些 耗 时 的 逻辑 ， 束 很 容 
易 出 现 ANR (Application Not Responding) 的 情况 。 


所 以 这 个 时 候 就 需要 用 到 Android 多 线程 编程 的 技术 了 ， 我 们 应 该 在 服务 的 


每 个 具体 的 方法 里 开启 一 个 子 线程 ， 然 后 在 这 里 去 处 理 那 些 耗 时 的 逻辑 。 
因此 ， 一 个 比较 标准 的 服务 吏 可 以 写成 如 下 形式 : 


public class MyService extends Service { 


QOverride 
public int onStartCommand(Intent intent, int flags, int StartId) { 
new Thread(new Runnable() { 
Q@Override 
public void run() { 
// 处 理 具体 的 逻辑 


} 
}).start(); 
return super.onSstartCcommand(intent, flags, startId); 


但 是 ， 这 种 服务 一 旦 启动 之 后 ， 束 会 一 直 处 于 运行 状态 ， 必 须 调用 
stopService() 或 者 stopself() 方法 才能 让 服务 停止 下 来 。 所 以 ， 如 果 想 要 
实现 让 一 个 服务 在 执行 完毕 后 自动 停止 的 功能 ， 就 可 以 这 样 写 : 


public class MyService extends Service { 


QOverride 
public int onStartCommand(Intent intent, int flags, int StartId) { 
new Thread(new Runnable() { 
@Override 
public void run() { 
// 处 理 具体 的 逻辑 
StopSelLf() ， 


}).start(); 


return super.onstartCcommand(intent, flags, startId); 


虽说 这 种 写法 并 不 复 淋 ， 但 是 总 会 有 一 些 程序 员 和 起 记 开 局 线程 ， 或 者 在 记 


调用 stopself() 方法 。 为 了 可 以 简单 地 创建 一 个 异步 的 、 会 自动 停止 的 服 
务 ，Android 专 门 提 供 了 一 个 Intentservice 类 ， 这 个 类 就 很 好 地 解决 了 前 面 
所 提 到 的 两 种 尴 碎 ， 下 面 我 们 束 来 看 一 下 它 的 用 法 。 


新 建 一 个 MyIntentservice 类 继承 目 Intentservice ， 代 码 如 下 所 示 : 


public class MyIntentService extends IntentService { 


public MyIntentService() { 
super("MyIntentService"); // 调用 父 类 的 有 参 构造 函数 


} 


QOverride 
protected void onHandleIntent(Intent intent) { 
// 打印 当前 线程 的 id 
Log.d("MyIntentService", "Thread id is " + Thread.currentThread(). getId()); 


QOverride 
public void onDestroy() { 
super .onDestroy(); 
Log.d("MyIntentService", "onDestroy executed"); 


这 里 自 先 要 提供 一 个 无 参 的 构造 男 数 ， 并 且 必 须 在 其 内 部 调用 父 类 的 有 参 
构造 男 数 。 然 后 要 在 子 类 中 去 实现 onHandleIntent() 这 个 抽象 方法 ， 在 这 
个 方法 中 可 以 去 处 理 一 些 具体 的 逻辑 ， 而 且 不 用 担心 ANR 的 问题 ， 因 为 这 
个 方法 已 经 是 在 子 线程 中 运行 的 了 。 这 里 为 了 证 实 一 下 ， 我 们 在 
onHandleIntent() 方法 中 打印 了 当前 线程 的 id。 另 外 根据 Intentservice 的 
特性 ， 这 个 服务 在 运行 结束 后 应 该 是 会 自动 停止 的 ， 所 以 我 们 又 重 写 了 
onDestroy() 方法 ， 在 这 里 也 打印 了 一 行 日 志 ， 以 证 实 服务 是 不 是 停止 掉 
可 | o 


接 下 来 修改 activity_main.xzml 中 的 代码 ， 加 入 一 个 用 于 局 动 MyIntentService 
这 个 服务 的 按钮 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/start_intent_service" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Start IntentService" /> 


</LinearLayout> 


然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


Q@Override 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 


Button startIintentService = (Button) findViewById(R.id.start_intent_ 
service); 


startIntentService.setOnclickListener(this); 


} 


QOverride 
public void onClick(View v) { 
Switch (v.getId()) { 


case R.id.start_intent_service: 
// 打印 主线 程 的 id 
Log.d("MainActivity", "Thread id is " + Thread.currentThread(). 
getId()); 
Intent intentService = new Intent(this, MyIntentService.class); 
startService(intentService); 
break; 
default: 
break; 


可 以 看 到 ， 我 们 在 Start IntentService 按 钮 的 点 击 事件 里 面 去 启动 
MyIntentService 这 个 服务 ， 并 在 这 里 打印 了 一 下 主线 程 的 id， 稍 后 用 于 和 
IntentService 进 行 比 对 。 你 会 发 现 ， 其 实 IntentService 的 用 法 和 普通 的 服务 没 
什么 两 样 。 


最 后 不 要 忘记 ， 服 务 都 是 需要 在 AndroidManifest,xzml 里 注册 的 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.servicetest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<service android:name=".MyIntentService" /> 


</application> 


</manifest> 


当然 你 也 可 以 使 用 Android Studio 提 供 的 快捷 方式 来 创建 IntentService， 不 过 
由 于 这 样 会 自动 生成 一 些 我 们 用 不 到 的 代码 ， 因 此 这 里 我 采用 了 手动 创建 
的 方式 。 


现在 重新 运行 一 下 程序 ， 界 面 如 图 10.14 所 示 。 


ServiceTest 


START SERVICE 


STOP SERVICE 


BIND SERVICE 


UNBIND SERVICE 


START INTENTSERVICE 


图 10.14 ”ServiceTest 更 新 后 的 主 界面 
点 击 Start IntentService 按 钮 后 ， 观 察 logcat 中 的 打印 日 志 ， 如 图 10.15 所 示 。 


Verbose 图 (Q- 


/com. example. servicetest D/MainActivity: Thread id is 1 


com. example. servicetest D/MyIntentService: Thread id is 154 


/com. example. servicetest D/MyIntentService: onDestroy executed 


图 10.15 ”启动 IntentService 时 的 打印 日 志 


可 以 看 到 ， 不 仅 MyIntentService 和 MainActivity 所 在 的 线程 id 不 一 样 ， 而 且 
onDestroy() 方法 也 得 到 了 执行 ， 说 明 MyIntentService 在 运行 完 元 毕 后 确实 目 
动 停止 了 。 集 开局 线程 和 目 动 停止 于 一 身 ，IntentService 还 是 博得 了 不 少 程 
序 员 的 喜爱 。 


好 了 ， 关 于 服务 的 知识 点 你 已 经 学 得 够 多 了 ， 下 面 就 让 我 们 进入 到 本 章 的 
最 佳 实践 环节 吧 。 


10.6 ”上 服务 的 最 佳 实践 一 一 完整 版 的 下 载 
示例 


本 章 中 你 已 经 掌握 了 很 多 关于 服务 的 使 用 技巧 ， 但 是 当 在 真正 的 项 目 里 需 
要 用 到 服务 的 时 候 ， 可 能 还 会 有 一 些 环 手 的 问题 让 你 不 知 所 指 。 因 此 ， 下 
人 笑 试 实现 一 个 在 服务 中 经 常会 使 用 到 的 功能 
= 


本 节 中 我 们 将 要 编写 一 个 完整 版 的 下 载 示 例 ， 其 中 会 涉及 第 7 章 、 第 8 章 、 
第 9 章 和 第 10 章 的 部 分 内 容 ， 算 是 目前 为 止 综合 程 度 最 高 的 一 个 例子 了 。 
备 好 了 吗 ? 创建 一 个 ServiceBestPractice 项 目 ， 然 后 开始 本 节 的 学 习 之 旅 
吧 。 


首先 我 们 需要 将 项 目 中 会 使 用 到 的 依赖 库 添 加 好 ， 编 辑 app/build.gradle 文 


we 


件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 


compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android.support:appcompat-v7:24.2.1" 
testCompile 'junit:junit:4.12"' 

compile 'com.squareup.okhttp3:okhttp:3.4.1" 


里 只 需 添 加 一 个 OkHttp 的 依赖 就 行 了 ， 待 会 儿 在 编写 网 络 相 关 的 功能 
时 我 们 将 使 用 OkHttp 来 进行 实现 。 


接 下 来 需要 定义 一 个 回调 接口 ， 用 于 对 下 载 过 程 中 的 各 种 状态 进行 监听 和 
回调 。 新 建 一 个 pownloadListener 接口 ， 代 码 如 下 所 示 : 


public interface DownloadListener { 


void onpProgress(int progress); 
void onSuccess(); 

void onFailed(); 

void onPaused() ， 


void onCanceled(); 


可 以 看 到 ， 这 里 我 们 一 共 定 义 了 5 个 回调 方法 ，onProgress() 方法 用 于 通知 
当前 的 下 载 进度 ，onsuccess() 方法 用 于 通知 下 载 成 功 事 件 ，onFailed() 方 


法 用 于 通知 下 载 失 败 事件 ，onpaused() 方法 用 于 通知 下 载 暂停 事件 ， 
onCanceled() 方法 用 于 通知 下 载 取 消 事件 。 


回调 接口 定义 好 了 之 后 ， 下 面 我 们 残 可 以 开始 编写 下 载 功能 了 。 这 里 我 准 
备 使 用 本 章 中 刚 学 的 AsyncTask 来 进行 实现 ， 新 建 一 个 pownloadTask 继承 上 自 


AsyncTask， 代 码 如 下 所 示 : 


public class DownloadTask extends AsyncTask<String, Integer, Integer> { 


public static final int TYPE_SUCCESS = 0; 
public static final int TYPE_FAILED = 1; 
public static final int TYPE_PAUSED = 2) 
public static final int TYPE_CANCELED = 3; 


private DownloadListener listener,; 
private boolean isCanceled = false; 
private boolean isPaused = false; 
private int lastProgress; 


public DownloadTask(DownloadListener listener) { 
this.listener = listener; 
} 


@Override 
protected Integer doInBackground(String... params) { 
InputStream is = null; 
RandomAccessFile savedFile = null; 
File file = null; 
try { 
long downloadedLength = 0; // 记录 已 下 载 的 文件 长 度 
String downloadUrl1 = params[0] ， 
String fileName = downloadUrl,.substring(downloadUr1.1astIndexof("/"))， 
String directory = Environment .getExternalStoragePub1icDirectory 
(Environment ,DIRECTORY_DOWNLOADS ) .getPath() ， 
file = new File(directory + fileName); 


if (file.exists()) { 
downloadedLength = file.length(); 
} 


long contentLength = getContentLength(downloadUr1); 
if (contentLength == 0) { 
return TYPE_FAILED ， 
} else if (contentLength == downloadedLength) { 
// 已 下 载 字 季 和 文件 总 字 节 相等 ， 说 明 已 经 下 载 完 成 了 
return TYPE_SUCCESS,; 


OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
// 断 点 下 载 ， 指 定 从 哪个 字 节 开始 下 载 
.addHeader ("RANGE", "bytes=" + downloadedLength + "-") 
.Url(downloadUr1) 
.build(); 
Response response = client.newCall(request).execute(); 
if (response != null) { 
is = response.body().byteStream( ); 
savedFile = new RandomAccessFile(file, "rw"); 
savedFile.seek(downloadedLength); // 跳 过 已 下 载 的 字 节 
byte[] b = new byte[1024]; 
int total = 0; 
int len; 
while ((len = is.read(b)) != -1) { 
if (isCanceled) { 
return TYPE_CANCELED,; 
} else if(isPaused) 区 
return TYPE_PAUSED,; 
} else { 
total += len; 
savedFile.write(b, 0, len); 
// 计算 已 下 载 的 百分比 
int progress = (int) ((total + downloadedLength) * 100 / 
contentLength); 
publishProgress(progress); 


} 
} 
response.body().close(); 
return TYPE_SUCCESS,; 


} catch (Exception e) { 
e,printStackTrace( ); 
} finally { 
try { 
if (is != nul1) { 
is.close(); 


} 

if (savedFile != null) { 
savedFile.close(); 

} 


if (isCanceled && file != null) 区 
file.delete( ); 
} 


} catch (Exception e) { 
e.printStackTrace(); 


} 
} 
return TYPE_FAILED,; 
} 
QOverride 
protected void onProgressUpdate(Integer... values) { 


int progress = values[0]; 
if (progress > lastProgress) { 
listener.onProgress(progress); 


lastProgress = progress; 


} 


QOverride 
protected void onPostExecute(Integer status) { 
Switch (status) { 
case TYPE_SUCCESS: 
listener.onSuccess(); 
break; 
case TYPE_FAILED: 
listener.onFailed(); 
break; 
case TYPE_PAUSED: 
listener.onpaused(); 
break; 
case TYPE_CANCELED: 
listener.onCanceled(); 
break; 
default: 
break; 


} 


public void pauseDownload() { 
isPaused = true; 
} 


public void cancelDownload() { 
isCanceled = true; 
} 


private long getContentLength(String downloadUrl1) throws IOException { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
.Url(downloadUr1) 
.build(); 
Response response = client.newCall(request).execute(); 
if (response != null && response.isSuccessful()) { 
long contentLength = response.body().contentLength(); 
response.body().close(); 
return contentLength; 
} 


return 0; 


这 上 段 代 码 就 比较 长 了 ， 我 们 需要 一 步 步 地 进行 分 析 。 首 先 看 一 下 AsyncTask 
中 的 3 个 泛 型 参数 : 第 一 个 泛 型 参数 指定 为 String ， 表示 在 执行 AsyncTask 
的 时 候 需 要 传 入 一 个 字符 串 参 数 给 后 台 任 务 ; 第 二 个 泛 型 参数 指定 为 

Integer ， 表 示 使 用 整 型 数据 来 作为 进度 显示 单位 ;第 三 个 泛 型 参数 指定 为 


Integer ， 则 表示 使 用 整 型 数据 来 反馈 执行 结 采 。 


接 下 来 我 们 定义 了 4 个 整 型 常量 用 于 表示 下 载 的 状态 ，TYPE_succEss 表示 下 
载 成 功 ，TYPE_FAILED 表示 下 载 失 败 ，TYPE_PAUSED 表示 和 暂停 下 载 ， 
TYPE_CANCELED 表示 取消 下 载 。 然 后 在 pownloadTask 的 构造 函数 中 要 求 传 入 
一 个 刚刚 定义 的 DownloadListener 参数 ， 我 们 待 会 融会 将 下 载 的 状态 通过 
这 个 参数 进行 回调 。 


接着 就 是 要 重 写 doInBackground() 、 onProgressUpdate() 和 
onPostExecute() 这 3 个 方法 了 ， 我 们 之 前 已 经 学 习 过 这 3 个 方法 各 目的 作 
用 ， 因 此 在 这 里 它们 各 目 所 负责 的 任务 也 是 明确 的 : doInBackground ( ) 方 
法 用 于 在 后 台 执 行 具 体 的 下 载 逻 辑 ， onProgressUpdate() 方法 用 于 在 界面 
上 更 新 当前 的 下 载 进度 ， onPostExecute() 用 于 通知 最 终 的 下 载 结 


那么 先 来 看 一 下 doInBackground() 方法 ， 首 移 我 们 从 参数 中 获取 到 了 下 载 
的 URL 地 址 ， 并 根据 URL 地 址 解析 出 了 下 载 的 文件 和 名， 然后 指定 将 文件 下 
载 到 Environment.DIRECTORY_DOWNLOADS 目 录 下 ， 也 就 是 SD 卡 的 
Download 目 未 。 我 们 还 要 判断 一 下 Download 目 孙 中 是 不 是 已 经 存在 要 下 载 
的 文件 了 ， 如 果 已 经 存在 的 话 则 读 取 已 下 载 的 字 和 蔬 数 ， 这 样 就 可 以 在 后 面 
启用 断 点 续 传 的 功能 接 下 来 先是 调用 了 getcontentLength( ) 方法 来 获取 
竺 下 载 文件 的 总 长 度 ， 如 果 文 件 长 度 等 于 0 则 说 明文 件 有 问题 ， 直 接 返 回 
TYPE_FAILED ， 如 果 文 件 长 度 等 于 已 下 载 文 件 长 度 ， 那 么 就 说 明文 件 已 经 下 
载 完了 ， 直 接 返 回 TyPE_succESss 即 可 。 紧 接着 使 用 OkHttp 来 发 送 一 条 网 络 
请 求 ， 需 要 注意 的 是 ， 这 里 在 请 求 中 添加 了 一 个 header， 用 于 告诉 服务 器 我 
们 想 要 从 哪个 字 节 开始 下 载 ， 因 为 已 下 载 过 的 部 分 就 不 需要 再 重新 下 载 

了 。 接 下 来 读 取 服务 器 响应 的 数据 ， 并 使 用 Java 的 文件 流 方式 ， 不断 从 网 络 
上 读 取 数据 ， 不 断 写 入 到 本 地 ， 一 直到 文件 全 部 下 载 完 成 为 止 。 在 这 个 过 
程 中 ， 我 们 还 要 判断 用 户 有 没有 触发 暂停 或 者 取消 的 操作 ， 如 果 有 的 话 则 
返回 TYPE_PAUSED 或 TYPE_CANCELED 来 中 断 下 载 ， 如 果 没 有 的 话 则 实时 计算 
当前 的 下 载 进 度 ， 然 后 调用 publishprogress() 方法 进行 通知 。 暂 停 和 取消 
操作 都 是 使 用 一 个 布尔 型 的 变量 来 进行 控制 的 ， 调用 pauseDownload() 或 
cancelDownload() 方法 即 可 更 改变 量 的 值 。 


接 下 来 看 一 下 onProgressUpdate() 方法 ， 这 个 方法 束 简 单 得 多 了 ， 它 首 先 
从 参数 中 获取 到 当前 的 下 载 进 度 ， 然 后 和 上 一 次 的 下 载 进度 进行 对 比 ， 如 
果 有 变化 的 话 则 调用 DownloadListener 的 onProg ress() 方法 来 通知 下 载 进度 
更 新 。 


最 后 是 onPostExecute( ) 方法 ， 也 非常 简单 ， 束 是 根据 参数 中 传 入 的 下 载 状 
态 来 进行 回调 。 下 载 成 功 束 调 用 DownloadListener 的 onsuccess() 方法 ， 下 


载 失 败 就 调用 onFailed() 方法 ， 暂停 下 载 就 调用 onPaused() 方法 ， 取消 下 
载 束 调用 oncanceled( ) 方法 。 


这 样 我 们 就 把 具体 的 下 载 功 能 完成 了 ， 下 面 为 了 保证 DownloadTask 可 以 一 


直 在 后 台 运 行 ， 我 们 还 需要 创建 一 个 下 载 的 服务 。 右 击 


com.example.servicebestpractice -New 一 Service -> Service， 新 建 
DownloadService， 然 后 修改 其 中 的 代码 ， 如 下 所 示 : 


public class DownloadService extends Service { 


private DownloadTask downloadTask; 


private String downloadUrl]; 


private DownloadListener listener = new DownloadListener() { 


}; 


@Override 
public void onProgress(int progress) { 
getNotificationManager().notify(1, getNotification("Downloading...", 
progress)); 


} 


Q@override 
public void onSuccess() { 
downloadTask = null; 
// 下 载 成 功 时 将 前 台 服 务 通知 关闭 ， 并 创 
stopForeground(true); 
getNotificationManager().notify(1, getNotification("Download Success", 
-1)); 
Toast.makeText (DownloadService.this, "Download Success", 
Toast .LENGTH_SHORT) .show( ); 


一 个 下 载 成 功 的 通知 


mi 


} 


@Override 
public void onFailed() { 
downloadTask = nuill; 
// 下 载 失 败 时 将 前 台 服 务 通知 关闭 ， 并 创建 一 个 下 载 失 败 的 通知 
stopForeground(true); 
getNotificationManager().notify(1, getNotification("Download Failed", 
-1)); 
Toast.makeText (DownloadService.this, "Download Failed", 
Toast .LENGTH_SHORT) .show( ); 


} 


@override 
public void onPaused() { 
downloadTask = nuill; 
Toast.makeText (DownloadService.this, "Paused", Toast.LENGTH_SHORT). 
Show( ); 


} 


Q@Override 
public void onCanceled() { 
downloadTask = null; 
stopForeground(true); 
Toast.makeText (DownloadService.this, "Canceled", Toast.LENGTH_SHORT). 
show( ); 


private DownloadBinder mBinder = new DownloadBinder(); 


QOverride 

public IBinder onBind(Intent intent) { 
return mBinder; 

} 


class DownloadBinder extends Binder { 


public void startDownload(String url) { 
if (downloadTask == null) { 
downloadUrl1 = url; 
downloadTask = new DownloadTask(listener); 
downloadTask.execute(downloadUr1); 
startForeground(1, getNotification("Downloading...", 0)); 
Toast.makeText (DownloadService.this, "Downloading...", Toast. 
LENGTH_SHORT) .show( ); 


} 


public void pauseDownload() { 
if (downloadTask != null) { 
downloadTask .pauseDownload( ); 
} 


} 


public void cancelDownload() { 
if (downloadTask != null) { 
downloadTask.cancelDownload(); 
} else { 
if (downloadUrl != null) { 
// 取消 下 载 时 需 将 文件 删除 ， 并 将 通知 关闭 
String fileName = downloadUrl.substring(downloadUr1. 
lastIindexof("/")); 
String directory = Environment.getExternalStoragePublicDirectory 
(Environment .DIRECTORY_DOWNLOADS ) .getPath(); 
File file = new File(directory + fileNanme); 
if (file.exists()) { 
file.delete( ); 
} 


getNotificationManager().cancel(1); 

stopForeground(true); 

Toast.makeText (DownloadService.this, "Canceled", 
Toast .LENGTH_SHORT) .show( ); 


} 


private NotificationManager getNotificationManager() { 
return (NotificationManager) getSystemService(NOTIFICATION_ SERVICE); 
} 


private Notification getNotification(String title, int progress) { 

Intent intent = new Intent(this, MainActivity.class); 

PendingIntent pi = PendingIntent.getActivity(this, 0, intent, 0); 

NotificationCompat.Builder builder = new NotificationCompat.Builder(this); 

builder.setSsmallIcon(R.mipmap.ic_launcher); 

builder.setLargeIcon(BitmapFactory.decodeResource(getResources(), 
R.mipmap.ic_launcher)); 

builder.setCcontentIntent(pi); 

builder.setCcontentTitle(title); 

if (progress > = 0) { 
// 当 progress 大 于 或 等 于 0 时 才 需 显示 下 载 进度 
builder.setContentText(progress + "%"); 


builder.setProgress(100, progress, false); 


} 
return builder.build(); 


} 


这 段 代码 同样 也 比较 长 ， 我 们 还 是 得 耐心 慢 慢 看 。 自 先 这 里 创建 了 一 个 
DownloadListener 的 匿名 类 实例 ， 并 在 匿名 类 中 实现 了 onprogress() S 


onSuccess() 、 onFailed() 、onPaused ( ) 和 oncanceled() 这 5 个 方法 。 在 
onprogress() 方法 中 ， 我 们 调用 getNotification() 方法 构建 了 一 个 用 于 显 
示 下 载 进 度 的 通知 ， 然 后 调用 NotificationManager 的 notify() 方法 去 触发 这 
个 通知 ， 这 样 就 可 以 在 下 拉 状 态 栏 中 实时 看 到 当前 下 载 的 进度 了 。 在 
onsuccess() 方法 中 ， 我 们 首先 是 将 正在 下 载 的 前 台 通 知 关 闭 ， 然 后 了 创建 
一 个 新 的 通知 用 于 告诉 用 户 下 载 成 功 了 。 其 他 几 个 方法 也 都 是 类 似 的 ， 分 
别 用 于 告诉 用 户 下 载 失 败 、 和 暂停 和 取消 这 几 个 事件 。 


接 下 来 为 了 要 让 DownloadService 可 以 和 活动 进行 通信 ， 我 们 又 创建 了 一 个 
DownloadBinder。DownloadBinder 中 提供 了 startDownload() 、 
pauseDownload() 和 cancelDpownload() 这 3 个 方法 ， 那 么 顾名思义 ， 它 们 分 别 
是 用 于 开始 下 载 、 和 暂停 下 载 和 取消 下 载 的 。 在 startpownload() 方法 中 ， 我 
们 创建 了 一 个 DownloadTask 的 实例 ， 把 刚才 的 DownloadListener 作 为 参数 传 
入 ， 然 后 调用 execute() 方法 开局 下 载 ， 并 将 下 载 文件 的 URL 地 址 传 入 到 
execute() 方法 中 。 同 时 ， 为 了 让 这 个 下 载 服务 成 为 一 个 前 台 服 务 ， 我 们 还 
调用 了 startForeground() 2 这 样 就 会 在 系统 状态 栏 中 创建 一 个 持续 运 
行 的 通知 了 。 接着 往 站 看 ， pauseDownload() 方法 中 的 代码 就 非常 简单 了 ， 
就 是 简单 地 调用 了 一 下 DownloadTask 中 的 pauseDownload() 方法 。 
cancelDownload() 方法 中 的 逻辑 也 基本 类 似 ， 但 是 要 注意 ， 取 消 下 载 的 时 
候 我 们 需要 将 正在 下 载 的 文件 删除 掉 ， 这 一 点 和 和 暂停 下 载 是 不 同 的 。 


另外 ，pownloadservice 类 中 所 有 使 用 到 的 通知 都 是 调用 getNotification() 
方法 进行 构建 的 ， 这 个 方法 中 的 代码 我 们 之 前 基本 都 是 学 过 的 ， 只 有 一 个 

setProgress() 方法 没有 见 过 。setProgress() 方法 接收 3 个 参数 ， 第 一 个 参 
数 传 入 通知 的 最 大 进度 ， 第 二 个 参数 传 入 通知 的 当前 进度 ， 第 三 个 参数 表 

示 是 否 使 用 模糊 进度 条 ， 这 里 传 入 false。 设 置 完 setprogress() 方法 ， 通 

知 上 束 会 有 进度 条 显示 出 来 了 。 


现在 下 载 的 服务 也 已 经 成 功 实现 ， 后 端的 工作 基本 都 完成 了 ， 那 么 接 下 来 
我 们 开始 编写 前 端的 部 分 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<Button 
android:id="@+id/start_download" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Start Download" /> 


<Button 
android:id="@+id/pause_download" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Pause Download" /> 


<Button 
android:id="@+id/cancel] download" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="Cancel] Download" /> 


</LinearLayout> 


布局 文件 还 是 非常 简单 的 ， 这 里 在 LinearLayout 中 放置 了 3 个 按钮 ， 分 别 用 
于 开始 下 载 、 和 暂停 下 载 和 取消 下 载 。 


然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private DownloadService.DownloadBinder downloadBinder; 
private ServiceConnection connection = new ServiceConnection() { 


Q@Override 
public void onServiceDisconnected(ComponentName name) { 


} 


@Override 

public void onServiceConnected(ComponentName name, IBinder service) { 
downloadBinder = (DownloadService.DownloadBinder) service,; 

} 


于 


Q@Override 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
SetContentView(R. Layout,activity_main) ， 
Button startDownload = (Button) findViewById(R.id.start_download); 
Button pauseDownload = (Button) findViewById(R.id,.pause_ download); 
Button cancelDownload = (Button) findViewById(R.id.cancel download); 
startDownload.setonclickListener(this); 
pauseDownload.setonclickListener(this); 
cancelDownload.setonClickListener(this); 
Intent intent = new Intent(this, DownloadService.class); 


startService(intent); // 启动 服务 

bindService(intent，connection，BIND_AUTO_CREATE); // 绑 定 服务 

if (ContextCompat.checkSelfPpermission(MainActivity.this, Manifest. 
permission.WRITE EXTERNAL_STORAGE)!'= PackageManager .PERMISSION_GRANTED) { 
ActivityCompat.requestPermissions(MainActivity.this, new 
String[]{ Manifest.permission. WRITE_ EXTERNAL_STORAGE }, 1); 


} 


QOverride 
public void onClick(View v) { 
If (downloadBinder == null) { 
return,; 


Switch (v.getId()) { 

case R.id.start_download: 

String url = "https://raw.githubusercontent.com/guolindev/eclipse/ 
master/eclipse-inst-win64.exe"; 

downloadBinder .startDownload(ur1l); 
break; 

case R.id.pause_download: 
downloadBinder .pauseDownload( ); 
break; 

case R.id.cancel download: 
downloadBinder .cancelDownload( ); 


break; 
default: 
break; 
} 
Q@Override 


public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 
case 1: 
If (grantResults. length > 0 && grantResults[0] != PackageManager. 
PERMISSION_GRANTED) { 


Toast .makeText(this, "拒绝 权限 将 无 法 使 用 程序 ",，Toast .LENGTH_SHORT). 


show( ) ， 
finish(); 
} 
break; 
default: 
} 

} 
Q@Override 


protected void onDestroy() { 
super.onDestroy(); 
unbindService(connection); 


可 以 看 到 ， 这 里 我 们 首先 创建 了 一 个 serviceconnection 的 匿名 类 ， 然 后 在 


onServiceConnected( ) 方法 中 获取 到 DownloadBinder 的 实例 ， 有 了 这 个 实 
例 ， 我 们 瓯 可 以 在 活动 中 调用 服务 提供 的 各 种 方法 了 。 


接 下 来 看 一 下 oncreate() 方法 ， 在 这 里 我 们 对 各 个 按钮 都 进行 了 初始 化 操 
作 并 设置 了 点 击 事件 ， 然 后 分 别 调用 了 startservice() 和 bindservice() 方 
法 来 启动 和 绑 定 服务 。 这 一 点 至 关 重 要 ， 因 为 局 动 服务 可 以 保证 
DownloadService 一 直 在 后 台 运 行 ， 绑 定 服 务 则 可 以 让 MainActivity 和 
DownloadService 进 行 通信 ， 因 此 两 个 方法 调用 都 必 不 可 少 。 在 oncreate() 
方法 的 最 后 ， 我 们 还 进行 了 wRITE_EXTERNAL_STORAGE 的 运行 时 权限 申请 ， 
为 下 载 文件 是 要 下 载 到 SD 卡 的 Download 目 孙 下 的 ， 如 果 没 有 这 个 权限 的 
话 ， 我 们 整个 程序 都 无 法 正常 工作 。 


接 下 来 的 代码 就 非常 简单 了 ， 在 onclick() 方法 中 我 们 对 点 击 事件 进行 判 
断 ， 如 果 点 击 了 开始 按钮 就 调用 DownloadBinder 的 startDbownload( ) 方法 ， 
如 果 点 击 了 暂停 按钮 就 调用 pauseDownload() 方法 ， 如 果 点 击 了 取消 按钮 就 
调用 cancelpownload( ) 方法 。startDownload() 方法 中 你 可 以 传 入 任意 的 下 
载 地 址 ， 这 里 我 使 用 了 一 个 Edlipse 的 下 载 地 址 ， 以 此 癌 这 个 Android 平 台 上 
曾经 最 出 色 的 开发 工具 致敬 。 


另外 还 有 一 点 需要 注意 ， 如 果 活 动 被 销毁 了 ， 那 么 一 定 要 记得 对 服务 进行 
解 顷 ， 不 然 束 有 可 能 会 造成 内 存 泄漏 。 这 里 我 们 在 onDestroy() 方法 中 完成 
了 解 绑 操 作 。 


现在 只 差 最 后 一 步 了 ， 我 们 还 需要 在 AndroidManifest.xml 文 件 中 声明 使 用 到 
的 权限 。 当 然 除 了 权限 之 外 ，MainActivity 和 DownloadService 也 是 需要 声明 
的 ， 不 过 Android Studio 应 该 后 束 帮 我 们 将 这 两 个 组 件 声明 好 了 ， 如 下 所 

人 小: 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.servicebestpractice"> 


<uses-permission android:name="android.permission.INTERNET" /> 
<uses-permission android:name="android.permission.WRITE_ EXTERNAL_STORAGE" /> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity android:name=" .MainActivity"> 
<intent-filter> 
<action android:name="android,.intent.action.MAIN" /> 


<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


<service 
android:name=" .DownloadService" 
android:enabled="true" 


android:exported="true" /> 
</application> 


</manifest> 


其 中 ， 由 于 我 们 的 程序 使 用 到 了 网 络 和 访问 SD 卡 的 功能 ， 因 此 需要 声明 


INTERNET 和 WRITE_EXTERNAL_STORAGE 这 两 个 权限 。 


这 样 所 有 代码 就 都 编写 完了 ， 现 在 终于 可 以 运行 一 下 程序 了 ， 如 图 10.16 所 
示 “。 


[Ba Allow 
ServiceBestPractice to 
access photos, media 
and files on your 


device? 


图 10.16 申请 访问 SD 卡 权限 


程序 一 启动 立刻 就 会 申请 访问 SD 卡 的 权限 ， 这 里 我 们 点 击 ALLOW， 然 后 
扩 击 Start Download 按 钮 束 可 以 开始 下 载 了 。 下 载 过 程 中 可 以 下 拉 系 统 状 态 
栏 查 看 实时 的 下 载 进度 ， 如 图 10.17 所 示 。 


Downloading... 


19% 


图 10.17 查看 实时 的 下 载 进度 


同时 ， 我 们 还 可 以 点 击 Pause Download 或 Cancel Download， 甚 至 于 晰 网 操 
作 来 测试 这 个 下 载 程 序 的 健壮 性 。 最 终 下 载 完 成 后 会 弹出 一 个 Download 
Success 的 通知 ， 然 后 我 们 可 以 通过 任意 一 个 文件 浏览 器 来 查看 一 下 SD 卡 的 
Download 目 录 ， 如 图 10.18 所 示 。 


/storage/emulated/0/Download 


ROOT DOWNLOAD 
325.81MB used 453.48MB free r/w 


[kk Parent folder 


[9 eclipse-inst-win64.exe 
4B:21 44.78MB rw-rw 


01 Jul 16 15 : 


图 10.18 ”查看 SD 卡 的 Download 目 录 
可 以 看 到 ， 文 件 已 经 成 功 下 载 下 来 了 。 


当然 ， 我 们 还 可 以 做 一 些 更 加 丰富 的 操作 ， 比 如 说 再 次 点 击 Start Download 
按钮 ， 你 会 发 现 程 序 会 立刻 弹出 一 个 Download Success 的 提示 ， 因 为 它 检测 
到 文件 已 经 下 载 完 成 了 ， 因 而 不 会 再 重新 去 下 载 一 裔 。 如 果 我 们 点 击 Cancel 
Download 按 钮 先 将 下 载 文件 删除 掉 ， 然 后 再 点 击 Start Download 按 钮 ， 你 就 
会 发 现 程序 又 会 开始 重新 下 载 了 。 


总 体 来 说 ， 这 个 下 载 示 例 的 稳定 性 还 是 挺 不 错 的 ， 而 且 综 合 性 很 强 ， 将 这 
个 示例 完全 掌握 了 之 后 ， 你 的 水 平 肯定 又 更 进一步 了 。 


好 了 ， 最 佳 实践 部 分 到 此 结束 ， 下 面 我 们 就 来 回顾 一 下 本 章 所 学 的 内 容 
吧 。 


10.7 ”小结 与 点 评 


在 本 章 中 ， 我 们 学 习 了 很 多 与 服务 相关 的 重要 知识 点 ， 包 括 Android 多 线程 
编程 、 服 务 的 基本 用 法 、 服 务 的 生命 周期 、 前 台 服 务 和 IntentService 等 。 这 
些 内 容 已 经 覆盖 了 大 部 分 你 在 日 常 开发 中 可 能 用 到 的 服务 技术 ， 再 加 上 最 
佳 实践 部 分 学 习 的 下 载 示 例 程序 ， 相 信 以 后 不 管 过 到 什么 样 的 服务 难题 ， 

你 都 能 从 容 解 决 。 


男 外 ， 本 章 同样 是 有 里 程 碑 式 的 纪念 意义 的 ， 因 为 我 们 已 经 将 Android 中 的 
四 大 组 件 全 部 学 完 ， 并 且 本 书 的 内 容 也 学 习 一 大 半 了 。 对 于 你 来 说 ， 现 在 
你 已 经 脱离 了 Android 初 级 开发 者 的 身份 ， 并 应 该 具备 了 独立 完成 很 多 功能 


那么 后 面 我 们 应 该 再 接 再 万 ， 争 取 进 一 步 提升 目 身 的 能 力 ， 所 以 现在 还 不 
是 放松 的 时 候 ， 下 一 章 中 我 们 准备 去 学 习 一 下 Android 符 色 开发 的 相关 内 


他 


第 11 章 Android 特 色 开 发 一 一 基于 
位 置 的 服务 


现在 你 已 经 学 会 了 非常 多 的 Android 技 能 ， 并 且 通 过 这 些 技能 你 完全 可 以 编 
写 出 相当 不 错 的 应 用 程序 了 。 不 过 本 章 中 ， 我 们 将 要 学 习 一 些 全 新 的 
Android 技 术 ， 这 些 技 术 有 别 于 传统 的 PC 或 Web 领 域 的 应 用 技术 ， 古 只 有 在 
移动 设备 上 才能 实现 的 。 


说 到 只 有 在 移动 设备 上 才能 实现 的 技术 ， 很 容易 就 让 人 联想 到 基于 位 置 的 

服务 (Location Based Service) 。 由 于 移动 设备 相 比 于 电脑 可 以 随身 携带 ， 

我 们 通过 地 理 定位 的 技术 就 可 以 随时 得 知 自己 所 在 的 位 置 ， 从 而 围绕 这 一 

点 开发 出 很 多 有 意思 的 应 用 。 本 章 中 我 们 就 将 针对 这 一 点 进行 讨论 ， 学 习 
下 基于 位 置 的 服务 究竟 是 如 何 实现 的 。 


11.1 基于 位 置 的 服务 简介 


二 


基于 位 置 的 服务 简称 LBS， 随 着 移动 互联 网 的 兴起 ， 这 个 技术 在 最 近 的 几 年 
里 十 分 火爆 。 其 实 它 本 身 并 不 是 什么 时 泼 的 技术 ， 主 要 的 工作 原理 就 是 利 
用 无 线 电 通讯 网 络 或 GPS 等 定位 方式 来 确定 出 移动 设备 所 在 的 位 置 ， 而 这 种 
定位 技术 早 在 很 多 年 前 就 已 经 出 现 了 。 


那 为 什么 LBS 技 术 直 到 最 近 几 年 才 开始 流行 呢 ? 这 主要 是 因为 ， 在 过 去 移动 
设备 的 功能 极其 有 限 ， 即 使 定位 到 了 设备 所 在 的 位 置 ， 也 就 仅仅 只 是 定位 
到 了 而 已 ， 我 们 并 不 能 在 位 置 的 基础 上 进行 一 些 其 他 的 操作 。 而 现在 就 大 
大 不 同 了 ， 有 了 Android 系 统 作 为 载体 ， 我 们 可 以 利用 定位 出 的 位 置 进 行 许 
多 丰富 多 彩 的 操作 。 比 如 说 天 气 预报 程序 可 以 根据 用 户 所 在 的 位 置 目 动 选 
择 城 市 ， 发 微 博 的 时 候 我 们 可 以 向 朋友 们 果 一 下 目 己 在 哪里 ,不 认识 路 的 
时 候 随 时 打开 地 图 束 可 以 查询 路 线 ， 等 等 。 


介绍 了 这 么 多 ， 相 信 你 已 经 按 探 不 住 了 吧 ? 我 们 马上 就 要 开始 本 章 的 学 习 
之 旅 ， 但 在 开始 之 前 ， 还 有 一 些 事情 是 你 必须 要 知道 的 。 


首先 你 要 清楚 ， 基 于 位 置 的 服务 所 围绕 的 核心 就 是 要 先 确 定 出 用 户 所 在 的 
位 置 。 通 常 有 两 种 技术 方式 可 以 实现 : 一 种 是 通过 GPS 定位 ， 一 种 是 通过 网 
络 定位 。 GPS 定位 的 工作 原理 是 基于 手机 内 置 的 GPS 硬件 直接 和 卫星 交互 来 
获取 当前 的 经 纬度 信息 ， 这 种 定位 方式 精确 度 非常 高 ， 但 缺点 是 只 能 在 室 
外 使 用 ， 室 内 基本 无 法 接收 到 卫星 的 信号 。 网 络 定位 的 工作 原理 是 根据 手 
机 当前 网 络 附近 的 三 个 基站 进行 测速 ， 以 此 计算 出 手机 和 每 个 基站 之 间 的 
距离 ， 再 通过 三 角 定 位 确定 出 一 个 大 概 的 位 置 ， 这 种 定位 方式 精确 度 一 
般 ， 但 优点 是 在 室内 室外 都 可 以 使 用 。 


Android 对 这 两 种 定位 方式 都 提供 了 相应 的 API 文 择 ， 但 是 由 于 一 些 特殊 原 

因 ，Google 的 网 络 服务 在 中 国 不 可 访问 ， 从 而 导致 网 络 定位 方式 的 API 失 

效 。 而 GPS 定位 虽然 不 需要 网 络 ， 但 是 必须 要 在 室外 才 可 以 使 用 ， 因 此 你 在 
0 0 
情况 。 


基于 以 上 原因 ， 我 决定 就 不 在 本 书 中 讲解 Android 原 生 定位 API 的 用 法 了 ， 
而 是 使 用 一 些 国内 第 三 方 公司 的 SDK。 目 前 国内 在 这 一 领域 做 得 比较 好 的 
二 个 是 百度 ， 一 个 是 高 估 ， 本 芝 我 们 就 来 学 习 一 下 百度 在 LBS 方 面 提供 的 
富 多 彩 的 功能 。 


11.2 ”申请 API Key 


要 想 在 自己 的 应 用 程序 里 使 用 百度 的 LBS 功 能 ， 首 先 必须 申请 一 个 API 
Key。 你 得 拥有 一 个 百度 账号 才能 进行 申请 ， 我 相信 大 多 数 人 早 就 已 经 拥有 
了 吧 ? 如 果 你 还 没有 的 话 ， 赶 快 去 注册 一 个 吧 。 


有 了 百度 账号 之 后 ， 我 们 就 可 以 申请 成 为 一 名 百度 开发 者 了 ， 登 录 你 的 百 
度 账 号 ， 并 打开 http://developer.baidu.com/user/reg 这 个 网 址 ， 在 这 里 填写 一 
些 注册 信息 即 可 ， 如 图 11.1 所 示 。 


* 类 型 : 个 ”OO 全 
* 开发 者 来 源 : | 开发 寺 > |@ 
* 开发 者 姓名 : 郭 过 ] 齐 
* 开发 者 简介 : Android 开 发 人 员 。 | © 
* Email 地 址 : Six*+xxzxxxasina.Com ”修改 
* 手机 号 : 159***##036 © 
* 验证 码 : 114039 | 本 
开发 者 官方 网 站 : 
品牌 LOGO : 112px*54px , 支持 PNG/JPG/GIF 格 式 ， 应 用 提交 至 PC 


Web 汇 道 时 进行 展示 


pe 


[v| 我 已 阅读 并 同意 百度 开放 云 平台 注册 协议 


图 11.1 填写 开发 者 信息 


只 需 填写 带 有 "“*” 号 的 那 部 分 内 容 就 足够 了 ， 接 下 来 点 击 提交 ， 会 显示 如 图 
11.2 所 示 的 界面 。 


填写 开发 者 信息 验证 邮箱 提交 应 用 / 使 用 开放 云 服务 
@ ©) 
验证 邮件 已 经 发 送 至 您 的 邮箱 si******** 7@sina.com 


请 点 击 邮 件 中 的 激活 链接 完成 验证 ， 即 可 使 用 百度 强大 的 应 用 分 发 法 道 和 丰富 的 开放 云 服务 。 


图 11.2 验证 邮箱 

接着 点 击 * 去 我 的 邮箱 ”， 将 会 进入 到 我 们 刚才 填写 的 邮箱 当中 ， 这 时 收 件 
箱 中 应 该 会 有 一 封 刚刚 收 到 的 邮件 ， 这 就 是 百度 发 送 给 我 们 的 验证 邮件 ， 
点 击 邮件 当中 的 链接 就 可 以 完成 注册 了 ， 如 图 11.3 所 示 。 


填写 开发 者 信息 验证 邮箱 提交 应 用 / 使 用 开放 云 服务 


@ S © 


邮箱 验证 成 功 ， 恭喜 您 成 为 百度 开发 者 ! 
百度 开放 云 平台 不 仅 将 百度 的 技术 和 大 数据 能 力 开放 给 广大 开发 者 ， 更 有 强力 的 应 用 推广 渠道 ， 
双 剑 合 壁 为 您 的 成 功 加 速 ! 


图 11.3 成 为 百度 开发 者 


到 此 一 切 顺 利 ! 这 样 你 就 已 经 成 为 一 名 百度 开发 者 了 。 接 着 访问 
http://lbsyun.baidu.com/apiconsole/key 这 个 地 址 ， 然 后 同意 百度 开发 者 协 
议 ， 会 看 到 如 图 11.4 所 示 的 界面 。 


回收 站 每 页 是 示 3( 时 
应 用 编号 。 应 用 各 称 沪 问 应 用 ( AK ) 应 用 类 别 备注 信息 ( 双击 更 改 ) 应用 配置 
“0 


图 11.4 百度 LBS 开 放 平 台 主 界面 


由 于 这 是 一 个 刚刚 注册 的 账号 ， 所 以 目前 的 应 用 列表 是 空 的 。 接 下 来 点 击 
创建 应 用 就 可 以 去 申请 API Key 了 ， 应 用 名 称 可 以 随便 填 ， 应 用 类 型 选择 
Android SDK， 启 用 服务 保持 默认 即 可 ， 如 图 11.5 所 示 。 


应 用 名 称 : LBSTest 
应 用 类 型 : Android SDK " 
园 王 失 李 API HD Javascript API - Place API v2 
加 Geocoding API v2 胃 JP 十 位 ARPI 明 路 线 文通 API 
轩 Android 地 图 SDK 园 Androld 导 航 高 线 SDK 呈 Androlid 导 航 SDK 
启用 服务 : 
要 静 志 图 API 加 全 最 静态 图 API 加 坐标 转 搁 API 
呈 座 艰 API 加 全 最 URL API 加 Android 导 航 HUD SDK 
器 云 这 地理 编码 API 胃 Routematrix API 
+ 点 布 版 SHA1 : 
开发 版 SHA1 : 
+ 包扎 
安全 码 : ”输入 shal 和 包 各 后 自动 生成 


Android SDK 安 全 码 组 成 : SHA1+ 包 和 名。( 查 看 详细 配置 方法 ) 


新 申请 的 Mobile 与 Browser 类 型 的 ak 不 再 支持 云 存 信 接 口 的 访问 ， 如 要 使 用 云 存储 ， 请 申请 Server 类 型 ak。 


图 11.5 创建 应 用 界面 


那么 ， 这 个 发 布 版 SHA1 和 开发 版 SHA1 又 是 个 什么 东西 呢 ? 这 是 我 们 申请 
API Key 所 必须 填写 的 一 个 字段 ， 它 指 的 是 打包 程序 时 所 用 签名 文件 的 本 


SHA1 指 纹 ， 可 以 通过 Android Studio 查 看 到 。 打 开 Android Studio 中 的 任意 


一 个 项 目 ， 点 击 右 侧 工 具 栏 的 Gradle » 项 目 名 一 :app 一 Tasks -~ android， 如 
图 11.6 所 示 。 


入 十 一 | 已 | 三 二 节 | 久 | 车 


pu 可 


T (© ServiceBestpractice 
bp (© ServiceBestpractice (rooi 
Y :app 
v EaTasks 
T Caandroid 
全 androidDependencies 


signingReport 


和 RsourceSets 
Fa build 
[3 help 
C3 install 
[3 other 
Ca verification 


Vv yy yy Vv vv 


图 11.6 查看 内 置 Gradle Tasks 


这 里 展示 了 一 个 Android Studio 项 目 中 所 有 内 置 的 Gradle Tasks， 其 中 
signingReport 这 个 Task 就 可 以 用 来 查看 签名 文件 信息 。 双 击 signingReport， 
结果 如 图 11.7 所 示 。 


Run (® ServiceBestPractice:app [signingReport] 


BP 个 22:50:17: Executing external task ”signingReport ... 
国 | 二 Configuration on demand is an incubating feature. 

车 3 Incremental java compilation is an incubating feature. 
加 图 :app:signingReport 

x 宣 Variant: debug 

? 一 Config: debug 


Store: C:\Users\Administrator\. android\debug. keystore 

Alias: AndroidDebugKey 

MD5: 45:62:8A:DE:20:85:67:24:FE:8E:23:81:03:16:81:6A 

SHA1: 91:16:04:30:C0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E 
Valid until: 2044 年 12 月 5 日 星期 一 


| 防 4Run 蚊 TODo 颇 6:Android Monitor Terminal ” 国 0: Messages 


图 11.7 signingReport Task 的 执行 结果 


其 中 ，91:16:04:30:C0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E 束 是 我 
们 所 需 的 SHA1 指 纹 了 ， 当 然 你 的 Android Studio 中 显示 的 指纹 和 我 的 肯定 是 
不 一 样 的 。 另 外 需要 注意 ， 目 前 我 们 使 用 的 是 debug.keystore 文 件 所 生成 的 
指纹 ， 这 是 Android 目 动 生 成 的 一 个 用 于 测试 的 签名 文件 。 而 当 你 的 应 用 程 
序 发 布 时 还 需要 创建 一 个 正式 的 签名 文件 ， 如 果 要 得 到 它 的 指纹 ， 可 以 在 
cmd 中 输入 如 下 命令 : 


keytool -list -v -keystore < 签名 文件 


然后 输入 正确 的 密码 就 可 以 了 。 创 建 签名 文件 的 方法 我 们 将 在 第 15 章 中 学 


习 


那么 也 就 是 说 ， 现 在 得 到 的 这 个 SHA1 指 纹 实际 上 是 一 个 开发 版 的 SHA1 指 

纹 ， 不 过 因为 暂时 我 们 还 没有 一 个 发 布 版 的 SHA1 指 纹 ， 因 此 这 两 个 值 都 填 
成 一 样 的 束 可 以 了 。 最 后 还 剩 下 一 个 包 名 选项 ， 虽 然 目 前 我 们 的 应 用 程序 

还 不 存在 ， 但 可 以 先 将 包 名 预定 下 来 ， 比 如 就 叫 com.example.lbstest， 这 样 
所 有 的 内 容 束 都 填写 完整 了 ， 如 图 11.8 所 示 。 


应 用 名 称 : LBSTest 


应 用 类 型 : Android SDK 


园 云 检 索 API 加 Javascript API 加 Place API v2 
加 Geocoding API v2 嘱 IiP 走 位 API 网 路 线 交 通 APIl 
加 Android 地 图 SDK 圈 Android 导 航 高 线 SDK 加 Android 导 航 SDK 
启用 服务 : 二 
网 静 志 图 Api 加 全 最 静 志 图 API 网 坐标 转 扶 APIi 
加 诺 旋 API 圈 全 景 URL API 加 Android 导 航 HUD SDK 
呈 王 送 地 理 编 码 API 园 Routematrix API 


+ 发 布 版 SHA1 : 91:16:04:30:C0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E 
开发 版 SHA1 : 91:16:04:30:C0:8B:6E:53:92;47:57:E6:FB:10:EF:08:1B:73:E6:3E @ 答 入 正 ; 
+ 包 名 : com.example.lbstest 


91:16:04:30:C0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E:com.example.lbstest 
91:16:04:30:CO0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E:com.example.lbstest 


Android SDK 安 全 码 组 成 : SHA1+ 包 各 ，( 查 看 详细 配置 方法 ) 
新 捉 请 的 Mobile 与 Browser 类 型 的 ak 不 再 支持 云 存储 接口 的 访问 ， 如 要 使 用 云 存 储 ， 请 申请 Server 类 型 ak. 


图 11.8 ”填写 完整 所 有 创建 应 用 的 信息 
接 下 来 点 击 提交 ， 应 用 就 应 该 创建 成 功 了 ， 如 图 11.9 所 示 。 


i 更 备注 信息 
应 用 编号 。 应 用 各 称 访问 应 用 ( AK ) 应 用 类 别 二 应 用 配置 
(双击 更 改 ) 
8351285 LBSTest ieVD2fHKM3msMfZtIOXAhFSzDiYGFIiwWL Android 请 R 焉 删除 
E71 1 


图 11.9 查看 已 创建 的 应 用 


其 中 ，i6VD2fHKM3msMfZtIOXAhFSzDiYGFIwL 就 是 申请 到 的 API Key， 
有 了 它 束 可 以 进行 后 续 的 LBS 开 发 工作 了 ， 那 么 我 们 马上 开始 吧 。 


11.3 ”使 用 百度 定位 


现在 正 是 趁 热 打铁 的 好 时 机 ， 新 建 一 个 LBSTest 项 目 ， 包 名 应 该 就 会 自动 被 
命名 为 com.example.lbstest。 男 外 需要 注意 ， 本 章 中 所 写 的 代码 建议 你 都 在 
手机 上 运行 ， 虽然 模 拟 器 中 也 提供 了 模拟 地 理 位 置 的 功能 ， 但 在 手机 上 可 
以 得 到 真实 的 位 置 数 据 ， 你 的 感受 会 更 加 深刻 。 


11.3.1 准备 LBS SDK 


在 开始 编码 之 前 ， 我 们 还 需要 先 将 百度 LBS 开 放 平 台 的 SDK 准 备 好 ， 下 载 地 
址 是 :http://lbsyun.baidu.com/sdk/download 。 本 章 中 我 们 会 用 到 基础 地 图 和 
定位 功能 这 两 个 SDK， 将 它们 勾 选 上， 然后 点 击 “ 开 发 包 ” 下 载 按 钮 即 可 ， 
如 图 11.10 所 示 。 


RO 


基础 地 图 ( 含 室内 图 ) 检索 功能 LBS 云 检索 计算 工具 


4 od 3 
定位 功能 导航 功能 ( 有 TTS ) 全 景 图 功能 


图 11.10 下 载 SDK 界 面 


下 载 完 成 后 对 该 压缩 包 解 讨 ， 其 中 会 有 一 个 libs 目 未 ， 这 里 面 的 内 容 就 是 我 
们 所 需要 的 一 切 了 ， 如 图 11.11 所 示 。 


名 称 关 型 大 小 
点 arm64-v8a 文件 去 

上 armeabi 文件 夫 

点 armeabi-v7a 文件 去 

是 x86 文件 去 

Bh x86 64 文件 夫 

时 | BaiduLBS_Android,ar Executable Jar File 


图 11.11 压缩 包 libs 目 录 下 的 内 容 


libs 目 录 下 的 内 容 又 分 为 两 部 分 ，BaiduLBS_Android.jar 这 个 文件 是 Java 层 要 
使 用 到 的 ， 其 他 子 目录 下 的 so 文件 是 Native 层 要 用 到 的 。so 文 件 是 用 
C/C++ 语言 进行 编写 ， 然 后 再 用 NDK 编 译 出 来 的 。 当 然 这 里 我 们 并 不 需要 
去 编写 C/C++ 的 代码 ， 因 为 百度 都 已 经 做 好 了 封装 ， 但 是 我 们 需要 将 libs 目 
录 下 的 每 一 个 文件 都 放置 到 正确 的 位 置 。 


首先 观 察 一 下 当前 的 项 目 结构 ， 你 会 发 现 app 模 块 下 面 有 一 个 libs 目 未 ， 这 
里 就 是 用 来 存放 所 有 的 Jar 包 的 ， 我 们 将 BaiduLBS_Android.jar 复 制 到 这 里 ， 
如 图 11.12 所 示 。 


E32 LBSTest 

DD .gradle 

DD .idea 

[3 app 
DD build 
户 libs 

目 BaiduLBS_AndroidJar 

户 src 
目 .gitignore 
[a app.iml 
( 公 build.gradle 


ls] proguard-rules.pro 


图 11.12 将 Jar 包 放置 到 libs 目 录 中 


接 下 来 展开 src/main 目 录 ， 右 击 该 目录 一 New 一 Directory， 再 创建 一 个 名 为 
jniLibs 的 目录 ， 这 里 束 是 专门 用 来 存放 so 文件 的 ， 然 后 把 压缩 包 里 的 其 他 所 
有 目录 直接 复制 到 这 里 ， 如 图 11.13 所 示 。 


中 src 
四 androidTest 
DD main 
Djava 
Djnilibs 
DD arm64-v8a 
DD armeabi 
DD armeabi-v7a 
口 x86 
口 x86 64 
C3 res 
BB AndroidManifest.xml 


图 11.13 将 so 文件 放置 到 jniLibs 目 录 中 


另外 ， 虽 然 所 有 新 创建 的 项 目 中 ，app/build.gradle 文 件 都 会 默认 配置 以 下 这 
段 声明 : 


dependencies 
compile fileTree(dir: 'libs', include: ['*.jar']) 


} 


这 表示 会 将 libs 目 录 下 所 有 以 .jar 结 尾 的 文件 添加 到 当前 项 目的 引用 中 。 但 是 
由 于 我 们 是 直接 将 Jar 包 复制 到 libs 目 录 下 的 ， 并 没有 修改 gradle 文 件 ， 因 此 
不 会 弹出 我 们 平时 熟悉 的 Sync Now 提 示 。 这 个 时 候 必 须 手动 点 击 一 下 
Android Studio 顶 部 工具 栏 中 的 Sync 按 钮 (图 11.14 中 最 左边 的 按钮 )” ， 不 然 
项 目 将 无 法 引用 到 Jar 包 中 提供 的 任何 接口 。 


S 二 
图 11.14 Android Studio 顶 部 工具 栏 


点 击 Sync 按 钮 之 后 ，libs 目 录 下 的 jar 文 件 束 会 多 出 一 个 向 右 的 箭头 ， 这 束 表 
示 项 目 已 经 能 引用 到 这 些 Jar 包 了 ， 如 图 11.15 所 示 。 


四 libs 
目 BaiduLBS_AndroldJar 


图 11.15 Jar 包 引 用 成 功 


好 了 ，1 


这 样 我 们 就 把 LBS 的 SDK 都 准备 好 了 ， 接 下 来 开始 编码 吧 。 


11.3.2 ”确定 自己 位 置 的 经 纬度 
首先 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<TextView 


android:id="@+id/position_text_view" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" /> 


</LinearLayout> 


布局 文件 中 的 内 容 非常 简单 ， 只 有 一 个 TextView 控 件 ， 用 于 稍 后 


置 的 经 纬度 信息 。 


然 


后 修改 AndroidManifest.xml 文 件 中 的 代码 ， 如 下 所 示 : 


当前 位 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.1lbstest"> 


<uses-permission android:name="android.permission.ACCESS _ COARSE_LOCATION"/> 
<uses-permission android:name="android.permission.ACCESS_FINE LOCATION"/> 


<uses-permission android:name="android.permission.ACCESS WIFI_STATE"/> 


<uses-permission android:name="android.permission.ACCESS NETWORK_STATE"/> 


<uses-permission android:name="android.permission.CHANGE WIFI_STATE"/> 
<uses-permission android:name="android.permission.READ_ PHONE_STATE"/> 


<uses-permission android:name="android.permission.WRITE_ EXTERNAL_STORAGE"/> 
<uses-permission android:name="android.permission.INTERNET"/> 
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> 
<uses-permission android:name="android.permission.WAKE_LOCK"/> 


<application 


android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<meta-data 
android:name="com.baidu.1lbsapi.API_KEY" 
android:value="i6VD2fHKM3msMfZtIOXAhFSzDiYGFIwL" /> 


<activity android:name=" .MainActivity"> 
<intent-filter> 
<action android:name="android,.intent.action.MAIN" /> 
<category android:name="android.intent.category .LAUNCHER" 
</intent-filter> 
</activity> 


/> 


<service android:name="com.baidu.location.f" android:enabled="true" 


android:process=":remote"> 


</service> 


</application> 


</manifest> 


AndroidManifest.xml 文 件 改动 比较 多 ， 我 们 来 仔细 阅读 一 下 。 可 以 看 到 ， 这 


里 自 先 添 加 了 很 多 行 权限 声明 ， 每 一 个 权限 都 是 百度 LBS SDK 内 部 要 用 到 
的 。 然 后 在 <application> 标签 的 内 部 添加 了 一 个 <meta-data> 标签 ， 这 个 
标签 的 android:name 部 分 是 固定 的 ， 必须 填 com.baidu.1lbsapi.API_KEY 
android:value 部 分 则 应 该 境 入 我 们 在 11.2 节 申请 到 的 API Key。 最 后 ， 还 需 


要 再 六 


FE 及 一 个 LBS SDK 中 的 服务 ， 不 用 对 这 个 服务 的 名 字 感 到 疑惑 ， 因 为 


百度 LBS SDK 中 的 代码 都 是 混 消 过 的 。 
接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


public LocationClient mLocationClient; 


private TextView positionText; 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 


} 


super.onCreate(savedInstanceState); 

mLocationClient = new LocationClient(getApplicationContext()); 

mLocationClient.registerLocationListener(new MyLocationListener()); 

setcontentView(R.1layout.activity_main); 

positionText = (TextView) findViewById(R.id.position text_view); 

List<String> permissionList = new ArrayList<>(); 

if (ContextCompat.checkSelfPpermission(MainActivity.this, Manifest. 
permission.ACCESS_FINE LOCATION)!'= PackageManager .PERMISSION GRANTED) { 
permissionList.add(Manifest.permission.ACCESS_FINE_ LOCATION); 


if (ContextCompat.checkSelfPpermission(MainActivity.this, Manifest. 
permission.READ_ PHONE_STATE) != PackageManager .PERMISSION GRANTED) { 
permissionList.add(Manifest.permission.READ_ PHONE_STATE); 

} 

if (ContextCompat.checkSelfPpermission(MainActivity.this, Manifest. 
permission.WRITE_ EXTERNAL_STORAGE)!'= PackageManager .PERMISSION_GRANTED) { 
permissionList.add(Manifest.permission.WRITE_ EXTERNAL_STORAGE); 

} 

if (!permissionList,.isEmpty()) { 
String [] permissions = permissionList.toArray(new String[permissionList. 

size()]); 

ActivityCompat.requestPermissions(MainActivity.this, permissions, 1); 

} else { 
requestLocation(); 

} 


private void requestLocation() { 


} 


mLocationClient.start(); 


Q@Override 
public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 
case 1: 
If (grantResults.length > 0) { 
for (int result : grantResults) { 
if (result != PackageManager .PERMISSION_ GRANTED) { 
Toast .makeText (this, "必须 同意 所 有 权限 才能 使 用 本 程序 "， 
Toast .LENGTH_SHORT) .show( ); 
finish(); 
return; 


} 
} 
requestLocation(); 
} else { 
Toast ,makeText(this，" 发 生 未 知 错误 "，Toast .LENGTH_SHORT).show(); 
finish(); 


break; 
default: 


} 


public class MyLocationListener implements BDLocationListener { 


Q@Override 
public void onReceiveLocation(BDLocation location) { 
runonUiThread(new Runnable() { 
QOverride 
public void run() { 
StringBuilder currentPosition = new StringBuilder(); 
currentPosition.append( "纬度 : ").append(location.getLatitude()). 
append("\n"); 
currentPosition.append( "经线 : ").append(location.getLongitude()). 
append("\n"); 
currentPosition.append(" 定 位 方式 : "); 
if (location.getLocType() == BDLocation.TypeGpsLocation) { 
currentPosition.append("GPS"); 
} else if (location.getLocType() == 
BDLocation.TypeNetwWorkLocation) { 
currentPosition.append(" 网 络 ") ， 


} 


positionText.setText(currentPosition); 


}); 
} 


Q@Override 
public void onConnectHotSpotMessage(String s, int i) { 


可 以 看 到 ， 在 oncreate() 方法 中 ， 我 们 首先 创建 了 一 个 Locationclient 的 
实例 ， LocationClient 的 构建 画 数 接收 一 个 context 参数 ， 这 里 调用 


getApplicationContext() 方法 来 获取 一 个 全 局 的 context 参数 并 传 入 。 然 
后 调用 Locationclient 的 registerLocationListener() 方法 来 注册 一 个 定位 
监听 右 ， 当 获取 到 位 置信 息 的 时 候 ， 束 会 回调 这 个 定位 监听 此 。 


接 下 来 看 一 下 这 里 运行 时 权限 的 用 法 ， 由 于 我 们 在 AndroidManifest.xml 中 声 
明了 很 多 权限 ， 参 考 一 下 7.2.1 小 节 中 的 危险 权限 表格 可 以 发 现 ， 其 中 
ACCESS_COARSE_LOCATION ~ ACCESS_ FINE LOCATION 、 READ PHONE_STATE 、 
WRITE_EXTERNAL_STORAGE 这 4 个 权限 是 需要 进行 运行 时 权限 处 理 的 ， 不 过 由 
于 ACCESS_COARSE_LOCATION 和 ACCESS_FINE_LOCATION 都 属于 同一 个 权限 组 ， 
因此 两 者 只 要 申请 其 一 就 可 以 了 。 那 么 怎样 才能 在 运行 时 一 次 性 申请 3 个 权 
限 呢 ? 这 里 我 们 使 用 了 一 种 狐 的 用 法 ， 首 移 创建 一 个 空 的 List 集 合 ， 然 后 依 
次 判断 这 3 个 权限 有 没有 被 授权 ， 如 果 没 被 授权 束 添 加 到 List 集 合 中 ， 最 后 
将 List 转 换 成 数组 ， 再 调用 Activitycompat .requestPermissions() 方法 一 次 
性 申请 。 


除 此 之 外 ， onRequestPermissionsResult() 方法 中 对 权限 申请 结果 的 逻辑 处 
理 也 和 之 前 有 所 不 同 ， 这 次 我 们 通过 一 个 循环 将 申请 的 每 个 权限 都 进行 了 
判断 ， 如 果 有 任何 一 个 权限 被 拒绝 ， 那 么 就 直接 调用 finish() 方法 关闭 当 
前 程序 ， 只 有 当 所 有 权限 都 被 用 户 同意 了 ， 才 会 调用 requestLocation( ) 方 
法 开始 地 理 位 置 定位 。 


requestLocation() 方法 中 的 代码 比较 简单 ， 只 是 调用 了 一 下 
LocationcClient 的 start() 方法 就 能 开始 定位 了 。 定 位 的 结果 会 回调 到 我 们 
前 面 注册 的 监听 屁 当 中 ， 也 就 是 MyLocationListener。 观察 一 下 
MyLocationListener 的 onReceiveLocation( ) 方法 中 ， 在 这 里 我 们 通过 
BDLocation 的 getLatitude() 方法 获取 当前 位 置 的 纬度 ， 通 过 
getLongitude() 方法 获取 当前 位 置 的 经 度 ， 通 过 getLocType( ) 方法 获取 当 
前 的 定位 方式 ， 最 终 将 结果 组 装 成 一 个 字符 串 ， 显 示 到 TextView 上 面 。 


现在 我 们 可 以 来 运行 一 下 程序 了 ， 如 图 11.16 所 示 。 军 无 疑问 ， 打 开 程序 首 
先 就 会 弹出 运行 时 权限 的 申请 对 话 框 ， 注 意 看 对 话 框 的 底部 ， 提 示 我 们 一 
共有 3 项 权限 申请 ， 当 前 十 第 1 项 ， 授 权 了 第 1 项 后 整 会 显示 第 2 项 ， 这 里 我 
们 全 部 后 击 允 许 ， 然 后 整 会 立刻 开始 定位 了 ， 结 果 如 图 11.17 所 示 。 
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图 11.16 运行 时 权限 申请 对 话 框 
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图 11.17 地 理 位 置 定 位 的 结果 
可 以 看 到 ， 设 备 当 前 的 经 纬度 信息 已 经 成 功 定 位 出 来 了 。 


不 过 ， 在 默认 情况 下 ， 调 用 LocationClient 的 start() 方法 只 会 定位 一 次 ， 如 
果 我 们 正在 快速 移动 中 ， 怎 样 才能 实时 更 新 当前 的 位 置 呢 ? 为 此 ， 百 度 LBS 
SDK 提 供 了 一 系列 的 设置 方法 ， 来 允许 我 们 更 改 默认 的 行为 ， 修 改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private void requestLocation() { 
initLocation(); 
mLocationClient.start(); 


} 


private void initLocation(){ 
LocationcCclientOption option = new LocationclientOption(); 


option,SsetScanSpan(5000 ) ， 
mLocationClient.setLocOption(option); 


} 


Q@Override 

protected void onDestroy() { 
super .onDestroy(); 
mLocationClient.stop(); 


这 里 增加 了 一 个 initLocation() 大 在 initLocation() 方法 中 我 们 创建 
了 一 人 Locationclientoption 对 象 ， 然后 调用 它 的 setscanspan() 方法 来 设 
置 更 新 的 间隔 。 这 里 传 入 了 5000， 表 示 每 5 秒 钟 会 更 新 一 下 当前 的 位 置 。 


最 后 要 记得 ， 在 活动 被 销毁 的 时 候 一 定 要 调用 Locationclient 的 stop() 方 
法 来 停止 定位 ， 不 然 程序 会 持续 在 后 台 不 停 地 进行 定位 ， 从 而 严重 消耗 手 
机 的 电量 。 


现在 重新 运行 一 下 程序 ， 然 后 拿 着 手机 随处 移动 ， 你 会 发 现 界 面 上 的 经 纬 
度 信 息 也 会 跟着 一 起 变化 的 。 


11.3.3 ”选择 定位 模式 


还 记得 在 本 章 刚 开始 的 时 候 说 过 ，Android 中 主要 有 两 种 定位 方式 吗 ? 一 种 
是 通过 GPS 定位 ， 一 种 是 通过 网 络 定位 。 而 从 上 一 小 下 中 的 例子 中 应 该 可 以 
看 出 ， 我 们 一 直 是 使 用 的 网 络 定 位 。 那 么 如 何 才能 切换 到 精确 度 更 高 的 GPS 
定位 昵 ?本 小 市 我 们 束 来 学 习 一 下 。 


首先 ，GPS 定 位 功能 必须 要 由 用 户主 动 去 启用 才 行 ， 不 然 任 何 应 用 程序 都 无 
0 GPS 获取 到 手机 当前 的 位 置信 息 。 进 入 手机 的 设置 ~ 位 置信 息 ， 如 图 
11.18 所 示 。 
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图 11.18 位 置信 息 设置 界面 


我 们 可 以 通过 顶部 的 开关 来 控制 定位 功能 是 开局 还 古 关 闭 ， 男 外 ， 点 击 “ 模 
式 ” 可 以 选择 具体 的 定位 模式 ， 如 图 11.19 所 示 。 


py BE 


《 位置 信息 模式 


仅 限 设备 O 


图 11.19 ”选择 具体 的 定位 模式 


其 中 ， 高 精确 度 模式 表示 允许 使 用 GPS、 无 线 网 络 、 蓝 牙 或 移动 网 络 来 进行 
定位 ， 世 电 模式 表示 仅 允 许 使 用 无 线 网 络 、 监 直 或 移动 网 络 来 进行 定位 ， 
而 仅 限 设备 模式 表示 仅 允 许 使 用 GPS 来 进行 定位 。 也 束 是 说 ， 如 采 我 们 想 要 
使 用 GPS 定位 功能 ， 这 里 必须 要 选择 高 精确 度 模式 ， 或 者 仅 限 设备 模式 。 


当然 ， 你 并 不 需要 担心 一 旦 启用 GPS 定位 功能 后 ， 手 机 的 电量 就 会 直线 下 
稍 ， 这 只 是 表明 你 已 经 同意 让 应 用 程序 来 对 你 的 手机 进行 GPS 定位 了 ， 但 只 
有 当 定 位 操作 真正 开始 的 时 候 ， 才 会 影响 到 手机 的 电量 。 


开启 了 GPS 定 位 功能 之 后 ， 再 回来 看 一 下 代码 。 我 们 可 以 在 initLocation() 
方法 中 对 百度 LBS SDK 的 定位 模式 进行 指定 ， 一 共有 3 种 模式 可 选 : 
Hight_Accuracy、Battery_Saving 和 Device_Sensors。Hight_Accuracy 表 示 高 精 


确 度 模式 ， 会 在 GPS 信号 正常 的 情况 下 优先 使 用 GPS 定位 ， 在 无 法 接收 GPS 
言 号 的 时 候 使 用 网 络 定 位 。Battery_Saving 表 示 节 电 模 式 ， 只 会 使 用 网 络 进 
行 定位 。Device_Sensors 表 示 传 感 需 模式 ， 只 会 使 用 GPS 进行 定位 。 其 中 ， 
Hight_Accuracy 是 默认 的 模式 ， 也 就 是 说 ， 我 们 即使 不 修改 任何 代码 ， 只 要 
0 让 手机 可 以 接收 到 GPS 信 号 ， 就 会 自动 切换 到 GPS 定 
立 模 式 了 。 


当然 我 们 也 可 以 强制 指定 只 使 用 GPS 进行 定位 ， 修 改 MainActivity 中 的 代 
码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private void initLocation(){ 
LocationCclientOption option = new LocationCclientOption(); 
option.setScanSpan(5000); 
option.setLocationMode(LocationClientOption.LocationMode.Device_ Sensors); 


mLocationClient.setLocOption(option); 


这 里 调用 本 setLocationMode() 方法 来 将 定位 模式 指定 成 传感器 模式 ， 也 就 
是 说 只 能 使 用 GPS 进 行 定 位 。 重 新 运行 一 下 程序 ， 人 然后 拿 着 你 的 手机 走 到 室 
外 去 结果 如 图 11.20 所 示 
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图 11.20 GPS 定位 的 结果 
11.3.4 看 得 懂 的 位 置信 息 


话说 回来 ， 刚 才 我 们 虽然 成 功 获取 到 了 设备 当前 位 置 的 经 纬度 信息 ， 但 遗 
憾 的 是 ， 这 种 经 纬度 的 值 一 般 人 是 根本 看 不 懂 的 ， 相 信 谁 也 无 法 立刻 答 出 
南 纬 25 度 、 东 经 148 度 是 什么 地 方 吧 ? 为 了 能 够 更 加 直观 地 阅读 ， 我 们 还 需 
要 学 习 一 下 如 何 获 取 看 得 懂 的 位 置信 息 。 

池 运 的 是 ， 百 度 LBS SDK 在 这 方面 提供 了 非常 好 的 支持 ， 我 们 只 需要 进行 
a 单 的 接口 调用 就 能 得 到 当前 位 置 各 种 丰富 的 地 址 信息 ， 下 面 就 来 一 
B 看 一 下 吧 。 


修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private void initLocation(){ 
LocationclientOption option = new LocationclientOption(); 
option.setScanSpan(5000); 
option.setIsNeedAddress(true); 
mLocationClient.setLocOption(option); 


public class MyLocationListener implements BDLocationListener { 


@override 
public void onReceiveLocation(BDLocation location) { 
runonUiThread(new Runnable() { 
QOverride 
public void run() { 

StringBuilder currentPosition = new StringBuilder(); 

currentPosition.append( "纬度 : ").append(location.getLatitude()). 
append("™\n"); 

currentPosition.append( "经线 : ").append(location.getLongitude()). 
append("\n"); 

currentPosition.append(" 国 家 : ").append(location.getCountry()). 
append("™\n"); 

currentPosition.append(" 省 : ").append(location.getProvince()). 
append("™\n"); 

currentPosition.append(" 市 : ").append(location.getCity()). 
append("\n"); 

currentPosition.append(" 区 : ").append(location.getDistrict()). 
append("\n"); 

currentPosition.append(" 街 道 : ").append(location.getSstreet()) 
append("\n"); 

currentPosition.append(" 定 位 方式 : "); 

if (location.getLocType() == BDLocation.TypeGpsLocation) { 
currentPosition.append("GPS"); 

} else if (location.getLocType() == 
BDLocation.TypeNetwWorkLocation) { 
currentPosition.append(" 网 络 ") ， 


} 


positionText.setText(currentPosition); 


首先 在 initLocation() 方法 中 ， 我 们 调用 了 LocationClientOption 的 


setIsNeedAddress() 方法 ， 并 传 入 true ， 这 就 表示 我 们 需要 获取 当前 位 置 
详细 的 地 址 信息 。 


接 下 来 在 MyLocationListener 的 onReceiveLocation( ) 方法 就 可 以 获取 到 各 种 
丰富 的 地 址 信息 了 ， 调 用 getcountry() 方法 可 以 得 到 当前 所 在 国家 ， 调 用 
getProvince( ) 方法 可 以 得 到 当前 所 在 省 份 ， 以 此 类 推 。 另 外 还 有 一 点 需要 
注意 ， 由 于 获取 地 址 信息 一 定 需要 用 到 网 络 ， 因 此 即使 我 们 将 定位 模式 指 
定 成 了 Device_Sensors， 也 会 目 动 开启 网 络 定 位 功能 。 


现在 重新 运行 一 下 程序 ， 结 果 如 图 11.21 所 示 。 
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图 11.21 获取 到 当前 位 置 的 地 址 信息 


可 以 看 到 ， 手 机 当前 位 置 的 地 址 信息 已 经 成 功 显 示 出 来 了 。 如 果 你 市 着 手 
机 移动 了 较 远 的 距离 ， 界 面 上 显示 的 位 置 也 会 跟着 一 起 变化 的 。 


11.4 ”使 用 百度 地 图 


现在 手机 地 图 的 应 用 真 的 可 以 算得 上 是 非常 广泛 了 ， 和 PC 上 的 地 图 相 比 ， 
手机 地 图 能 够 随时 随地 进行 查看 ， 并 且 轻 松 构建 出 行路 线 ， 使 用 起 来 明显 
更 加 地 方便 。 但 是 你 有 没有 想 过 ， 其 实 我 们 在 目 己 的 应 用 程序 里 也 是 可 以 
加 入 地 图 功能 的 ， 比 如 优 步 中 使 用 的 束 是 百度 地 图 。 本 万 我 们 就 来 学 习 一 
下 这 方面 的 知识 。 


11.4.1 让 地 图 显示 出 来 


由 于 在 上 一 节 中 我 们 已 经 将 LBS SDK 全 部 准备 好 了 ， 其 中 就 包括 了 地 图 功 
能 ， 因 此 这 里 避 ® 不 用 再 去 下 载 百 度 地 图 的 SDK 了 。 


那么 我 们 直接 在 LBSTest 项 目的 基础 上 进行 开发 ， 修 改 activity_main.xml 中 的 
代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" > 


<TextView 
android:id="@+id/position_text_view" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:visibility="gone" /> 


<com.baidu.mapapi.map.MapView 
android:id="@+id/bmapView" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:clickable="true" /> 


</LinearLayout> 


这 里 在 布局 文件 中 新 放置 了 一 个 MapView 控 件 ， 并 让 它 填 充满 整个 屏幕 。 


这 个 MapView 是 由 百度 提供 的 自 定义 控件 ， 所 以 在 使 用 它 的 时 候 需 要 将 完 
整 的 包 名 加 上 。 另 外， 之 前 用 于 显示 定位 信息 的 TextView 现 在 暂时 用 不 到 
了 ， 我 们 将 它 的 visibility 属性 指定 成 gone ， 让 它 在 界面 上 隐藏 起 来 。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private MapView mapView; 


QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
mLocationClient = new LocationClient(getApplicationContext()); 
mLocationClient.registerLocationListener(new MyLocationListener()); 
SDKInNnitializer.initialize(getApplicationContext()); 
setCcontentView(R.1layout.activity_main); 
mapView = (MapView) findViewById(R.id.bmapView); 


QOverride 

protected void onResume() { 
super .onResume(); 
mapView.onResume( ) ， 


} 


QOverride 

protected void onPause() { 
super .onPpause( ); 
mapView.onpause(); 


} 


QOverride 

protected void onDestroy() { 
super .onDestroy(); 
mLocationClient.stop(); 
mapView.onDestroy(); 


可 以 看 到 ， 这 里 的 代码 也 非常 简单 。 首 先 需 要 调用 SDKInitializer 的 
initialize() 方法 来 进行 初始 化 操作 ， initialize() 方法 接收 一 个 context 
参数 ， 这 里 我 们 调用 getApplicationcontext() 方法 来 获取 一 个 全 局 的 
Context 参数 并 传 入 。 注意 初始 化 操作 一 定 要 在 setcontentVview() 方法 前 调 
用 ,不 然 的 话 束 会 出 错 。 接 下 来 我 们 调用 findviewById() 方法 获取 到 了 
MapView 的 实例 ， 这 个 实例 在 后 面 的 功能 当中 还 会 用 到 。 


另外 还 需要 重 写 onResume() 、onPause() 和 onDestroy() 这 3 个 方法 ， 在 这 
对 MapView 进 行 管理 ， 以 保证 资源 能 够 及 时 地 得 到 释放 。 


好 了 ， 就 是 这 么 简单 。 现 在 重新 运行 一 下 程序 ， 百 度 地 图 职 应 该 成 功 显 示 
出 来 了 ， 如 图 11.22 所 示 。 


LBSTest 


图 11.22 让 百度 地 图 显示 出 来 


11.4.2 ”移动 到 我 的 位 置 


地 图 是 成 功 显 示 出 来 了 ,但 也 许 这 并 不 是 你 想 要 的 。 因 为 这 是 一 张 默 认 的 
地 图 ， 显 示 的 是 北京 市 中 心 的 位 置 ， 而 你 可 能 希望 看 到 更 加 精细 的 地 图 信 
思 ， 比 如 说 目 己 所 在 位 置 的 周边 环境 。 显 然 ， 通 过 缩放 和 移动 的 方式 来 慢 
慢 找到 目 己 的 位 置 是 一 种 很 妃 磊 的 做 法 。 那 么 本 小 节 我 们 殉 来 学 习 一 下 ， 
如 何 才 能 在 地 图 中 快速 移动 到 目 己 的 位 置 。 


百度 LBS SDK 的 API 中 提供 了 一 个 BaiduMap 类 ， 它 是 地 图 的 总 控制 器 ， 调 用 
MapView 的 getMap() 方 法 就 能 获取 到 BaiduMap 的 实例 ， 如 下 所 示 : 


BaiduMap baiduMap = mapView.getMap(); 


有 了 BaiduMap 后 ， 我 们 避 ® 能 对 地 图 进行 各 种 各 样 的 操作 了 ， 比 如 设置 地 图 
的 缩放 级 别 以 及 将 地 图 移动 到 某 一 个 经 纬度 上 。 


百度 地 图 将 缩放 级 别 的 取 值 范围 限定 在 3 到 19 之 间 ， 其 中 小 数 点 位 的 值 也 是 
可 以 取 的 ， 值 越 大 ， 地 图 显示 的 信息 就 越 精细 。 比 如 我 们 想 要 将 缩放 级 别 
设置 成 12.5， 就 可 以 这 样 写 : 


MapStatusUpdate update = MapStatusUpdateFactory .zoomTo(12.5f)， 
baiduMap .animateMapStatus(update ) ， 


其 中 MapStatusUpdateFactory 的 zoomTo( ) 方法 接收 一 个 float 型 的 参数 ， 整 
是 用 于 设置 缩放 级 别 的 ， 这 里 我 们 传 入 12.5f。zoomTo() 方法 返回 一 个 
MapstatusUupdate 对 象 ， 我 们 把 这 个 对 象 传 入 BaiduMap 的 
animateMapStatus() 方法 当中 即 可 完成 缩放 功能 。 


那么 怎样 才能 让 地 图 移动 到 某 一 个 经 纬度 上 呢 ? 这 就 需要 借助 LatLng 类 
了 。 其 实 LatLng 并 没有 什么 太 多 的 用 法 ， 主 要 就 是 用 于 存放 经 纬度 值 的 ， 
它 的 构造 方法 接收 两 个 参数 ， 第 一 个 参数 是 纬度 值 ， 第 二 个 参数 是 经 度 
值 。 之 后 调用 MapStatusUpdateFactory 的 newLatLng() 方法 将 LatLng 对 象 传 
入 ， newLatLng() 方法 返回 的 也 是 一 [ "MapStatusUpdate 对 象 ， 我 们 再 把 这 
个 对 象 传 入 BaiduMap 的 animateMapSstatus() 方法 当中 ， 就 可 以 将 地 图 移动 
到 指定 的 经 纬度 上 了 ， 写 法 如 下 : 


LatLng 11 = new LatLng(39.915, 116.404); 
MapStatusUpdate update = MapStatusUpdateFactory.newLatLng(11); 
baiduMap.animateMapStatus(update); 


上 述 代 码 就 实现 了 将 地 图 移动 到 北纬 39.915 度 、 东 经 116.404 度 这 个 位 置 的 


了 解 了 这 些 知识 之 后 ， 接 下 来 再 去 实现 将 地 图 快速 移动 到 自己 位 置 的 功能 
就 变 得 非常 简单 了 。 首 先 我 们 可 以 利用 在 11.3 节 中 所 学 的 定位 技术 来 获得 自 


己 当 前 位 置 的 经 纬度 ， 之 后 再 按照 上 述 的 方法 来 将 地 图 移动 到 指定 的 位 置 
束 可 以 了 。 


那么 下 面 我 们 就 来 继续 完善 LBSTest 这 个 项 目 ， 加 入 “移动 到 我 的 位 置 * 这 
功能 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private BaiduMap baiduMap; 
private boolean isFirstLocate = true; 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedIinstanceState); 
mLocationClient = new LocationClient(getApplicationContext()); 
mLocationClient.registerLocationListener(new MyLocationListener()); 
SDKINnitializer.initialize(getApplicationContext()); 
setcontentView(R.1layout.activity_main); 
mapView = (MapView) findViewById(R.id.bmapView); 
baiduMap = mapView.getMap(); 


} 


private void navigateTo(BDLocation location) { 
if (isFirstLocate) { 

LatLng 11 = new LatLng(location.getLatitude(), location.getLongitude()); 
MapStatusUpdate update = MapStatusUpdateFactory.newLatLng(11); 
baiduMap.animateMapStatus(update); 
update = MapStatusUpdateFactory.zoomTo(16f); 
baiduMap.animateMapStatus(update); 
isFirstLocate = false; 


4 
public class MyLocationListener implements BDLocationListener { 


Q@Override 
public void onReceiveLocation(BDLocation location) { 
if (location.getLocType() == BDLocation.TypeGpsLocation 
|| location.getLocType() == BDLocation.TypeNetworkLocation) { 
navigateTo(location); 


这 里 并 没有 新 增多 少 人 代码， 主要 是 加 入 了 一 个 navigateTo() 方法 。 这 个 方 
法 中 的 代码 也 很 好 理解 ， 先 是 将 BpDLocation 六 征询 吉 现 人 客人 向 取出 关 
封装 到 LatLng 对 象 中 ， 然 后 调用 MapStatusUpdateFactory 的 newLatLng() 方法 
并 将 LatLng 对 象 传 入 ， 接 着 将 返回 的 Mapstatusupdate 对 象 作 为 参数 传 入 到 


BaiduMap 的 animateMapSstatus() 方法 当中 ， 和 上 面 介绍 的 用 法 是 一 模 一 样 
的 。 并 且 这 里 为 了 让 地 图 信息 自 林 以 显示 得 更 加 丰富 一 些 ， 我 们 将 缩放 级 别 
设置 成 了 16。 丸和 外 还 有 一 点 需要 注意 ， 上 述 代码 当中 我 们 使 用 了 一 个 
isFirstLocate 变量 ， 这 个 变量 的 作用 是 为 了 防止 多 次 调用 
animateMapStatus() 方法 ， 因 为 将 地 图 移动 到 我 们 当前 的 位 置 只 需要 在 程 
序 第 一 次 定位 的 时 候 调 用 一 次 就 可 以 了 。 


写 好 了 navigateTo( ) 方法 之 后 ， 剩 下 的 事情 就 简单 了 ， 当 定位 到 设备 当前 
位 置 的 时 候 ， 我 们 在 onReceiveLocation() 方法 中 直接 把 BpLocation 对 象 传 
给 navigateTo() 方法 ， 这 样 就 能 够 让 地 图 移动 到 设备 所 在 的 位 置 了 。 


现在 重新 运行 一 下 程序 ， 结 果 如 图 11.23 所 示 。 
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图 11.23 将 地 图 移动 到 设备 所 在 的 位 置 


11.4.3 ”证 < 我 > 显示 在 地 图 上 


现在 我 们 已 经 可 以 让 地 图 显示 我 们 周边 的 环境 了 ， 但 是 相信 在 你 平时 使 用 
手机 地 图 时 应 该 会 注意 到 ， 通 常情 况 下 手机 地 图 上 应 该 都 会 有 一 个 小 光 
标 ， 用 于 显示 设备 当前 所 在 的 位 置 ， 并 且 如 果 设 备 正 在 移动 的 话 ， 那 么 这 
个 光标 也 会 跟着 一 起 移动 。 那 么 我 们 现在 束 继 续 对 现 有 代码 进行 扩展 ， 

让 “我 "能 够 显示 在 地 图 上 。 


百度 LBS SDK 当 中 提供 了 一 个 MyLocationData.Builder 类 ， 这 个 类 是 用 来 
封装 设备 当前 所 在 位 置 的 ， 我 们 只 需 将 经 纬度 信息 传 入 到 这 个 类 的 相应 方 
法 当中 束 可 以 了 ， 如 下 所 示 : 


MyLocationData.Builder locationBuilder = new MyLocationData.Builder(); 
locationBuilder.latitude(39.915); 
locationBuilder.longitude(116.404); 


MyLocationData.Builder 类 还 提供 了 一 人 1 build() 方法 ， 当 我 们 把 要 封装 的 
信息 都 设置 完成 之 后 ， 只 需要 调用 它 的 build() 方法 ， 就 会 生成 一 个 
MyLocationData 的 实例 ， 然 后 再 将 这 个 实例 传 入 到 BaiduMap 的 
setMyLocationData() 方法 当中 ， 就 可 以 让 设备 当前 的 位 置 显 示 在 地 图 上 
了 写法 加 下 


MyLocationData locationData = locationBuilder .build(); 
baiduMap.setMyLocationData(locationData); 


大 体 思 路 下 是 这 个 样子 ， 下 面 我 们 开始 来 实现 一 下 ， 修 改 MainActivity 中 的 
代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
mLocationClient = new LocationClient(getApplicationContext()); 
mLocationClient.registerLocationListener(new MyLocationListener()); 
SDKInNnitializer.initialize(getApplicationContext()); 
setcontentView(R.1layout.activity_main); 
mapView = (MapView) findViewById(R.id.bmapView); 
baiduMap = mapView.getMap(); 
baiduMap.setMyLocationEnabled(true); 


} 


private void navigateTo(BDLocation location) { 
if (isFirstLocate) { 
LatLng 11 = new LatLng(location.getLatitude(), location.getLongitude()); 
MapStatusUpdate update = MapStatusUpdateFactory.newLatLng(11); 
baiduMap.animateMapStatus(update); 
update = MapStatusUpdateFactory.zoomTo(16f); 
baiduMap .animateMapStatus(update ) ， 
isFirstLocate = false; 
} 
MyLocationData.Builder locationBuilder = new MyLocationData.Builder(); 
JocationBuilder.latitude(location.getLatitude()); 
locationBuilder.longitude(location.getLongitude()); 
MyLocationData locationData = locationBuilder .build(); 
baiduMap.setMyLocationData(locationData); 


} 


Q@Override 

protected void onDestroy() { 
super.onDestroy(); 
mLocationClient.stop(); 
mapView.onDestroy(); 
baiduMap.setMyLocationEnabled(false); 


可 以 看 到 ， 在 navigateTo() 方法 中 ， 我 们 添加 了 MyLocationData 的 构建 逻 


辑 ， 将 Location 中 包含 的 经 度 和 纬度 分 别 封装 到 了 MyLocationData.Builder 当 
中 ， 最 后 把 MyLocationData 设 置 到 了 BaiduMap 的 setMyLocationData( ) 方法 
当中 。 注 意 这 上 段 逻 辑 必 须 写 在 isFirstLocate 这 个 if 条 件 语句 的 外 面 ， 因 为 
让 地 图 移动 到 我 们 当前 的 位 置 只 需要 在 第 一 次 定位 的 时 候 执行 ， 但 是 设备 
在 地 图 上 显示 的 位 置 却 应 该 是 随 着 设备 的 移动 而 实时 改变 的 。 


另外 ， 根 据 百度 地 图 的 限制 ， 如 果 我 们 想 要 使 用 这 一 功能 ， 一 定 要 事先 调 
用 BaiduMap 的 setMyLocationEnabled() 方法 将 此 功能 开启， 否则 设备 的 位 
° 而 在 程序 退出 的 时 候 ， 也 要 记得 将 此 功能 给 关闭 
证 o 


忠 古 这 么 简单 ， 现 在 重新 运行 一 下 程序 ， 结 果 如 图 11.24 所 示 。 
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图 11.24 让 “我 "显示 在 地 图 上 
这 样 的 话 ， 用 户 就 可 以 非常 清晰 地 看 出 自己 当前 是 在 哪里 了 。 


关于 百度 LBS SDK 的 用 法 我 就 准备 介绍 这 么 多 ， 现 在 你 已 经 算是 成 功 入 门 
了 。 如 果 想 要 更 加 深入 地 人 研究 百度 LBS 的 各 种 用 法 ， 可 以 到 官方 网 站 上 面 参 
考 开发 指南 ， 地 址 是 : http://lbsyun.baidu.com 。 男 外 ， 百 度 LBS SDK 的 版 本 
未 来 随时 都 有 可 能 更 新 ， 也 许 更 新 之 后 会 导致 书 上 的 例子 无 法 正常 运行 ， 
因此 除了 照 着 图 书 学 习 之 外 ， 根 据 官 网 的 开发 指南 来 进行 学 习 也 是 非常 重 
要 的 ， 因 为 官方 文档 永远 都 是 最 新 的 。 


好 了 ， 本 章 的 主体 内 容 到 这 里 就 结束 了 。 下 面 我 们 将 再 次 进入 本 书 的 特殊 
环节 ， 学 习 一 下 关于 Git 的 高 级 用 法 。 


11.5” ”Git 时间 一 一 版 本 控制 工具 的 高 级 
现在 的 你 对 于 Git 应 该 完全 不 会 感到 陌生 了 吧 ， 通 过 了 之 前 两 节 内 容 的 学 
习 ， 你 已 经 掌握 了 很 多 Git 中 常用 的 命令 ， 像 提交 代码 这 种 简单 的 操作 相信 
肯定 是 难 不 倒 你 的 。 

那么 打开 Git Bash， 并 进入 到 LBSTest 这 个 项 目的 根 目录 ， 然 后 执行 提交 操 
作 : 


git init 
git add ， 
git commit -~m "First Commit." 


这 样 束 将 准备 工作 完成 了 ， 下 面 束 让 我 们 开始 学 习 关 于 Git 的 高 级 用 法 。 


11.5.1 分 支 的 用 法 


分 文 是 版 本 控制 工具 中 比较 高 级 且 比 较 重 要 的 一 个 概念 ， 它 主要 的 作用 就 
是 在 现 有 代码 的 基础 上 开辟 一 个 分 又 口 ， 使 得 代码 可 以 在 主干 线 和 分 文 线 
ee 且 相 互 之 间 不 会 影响 。 分 支 的 工作 原理 示意 图 如 图 11.25 
a 


分 支线 


主干 线 


〇 表示 一 次 提交 
图 11.25 分 支 的 工作 原理 示意 图 


你 也 许 会 有 疑惑 ， 为 什么 需要 建立 分 文 呢 ? 只 在 主干 线 上 进行 开发 不 是 挺 
好 的 吗 ? 没 错 ， 通 第 情 况 下 ， 只 在 主干 线 上 进行 开发 古 完 全 没有 问题 的 ， 
不 过 一 旦 涉及 出 版 本 的 情况 ， 如 果 不 建立 分 支 的 话 ， 你 就 会 非常 地 头疼 。 
举 个 简单 的 例子 吧 ， 比 如 说 你 们 公司 研发 了 一 款 不 错 的 软件 ， 最 近 刚 刚 完 
成 ， 并 推出 了 1.0 版 本 。 但 是 领导 是 不 会 让 你 们 朵 着 的 ， 马 上 提出 了 新 的 需 
求 ， 让 你 们 投入 到 了 1.1 版 本 的 开发 工作 当中 。 过 了 几 个 星期 ，1.1 版 本 的 功 
能 已 完成 了 一 半 ， 但 息 这 个 时 候 有 用 户 反 馈 ， 之 前 上 线 的 1.0 版 本 发 现 了 几 
个 重大 的 bug， 严 重 影响 软件 的 正常 使 用 。 领 导 也 相当 重视 这 个 问题 ， 要 求 
你 们 立刻 修复 这 些 pug， 并 重新 发 布 1.0 版 本 ， 但 这 个 时 候 你 就 非常 为 难 了 ， 
你 会 发 现 根本 没 法 去 修复 这 些 bug。 因 为 现在 1.1 版 本 已 开发 一 半 了 ， 如 采 在 
代码 的 基础 上 修复 这 些 bug， 那 么 更 新 的 1.0 版 本 将 会 膏 有 一 半 1.1 版 本 
功能! 


进退 两 难 了 是 不 是 ? 但 是 如 果 你 使 用 了 分 支 的 话 ， 束 完全 不 会 存在 这 个 让 
人 头疼 的 问题 。 你 只 需要 在 发 布 1.0 版 本 的 时 候 建 立 一 个 分 文 ， 然 后 在 主干 
线 上 继续 开发 1.1 版 本 的 功能 。 当 1.0 版 本 上 发 现任 何 bug 的 时 候 ， 就 在 分 支 
线 上 进行 修改 ， 然 后 发 布 狐 的 1.0 版 本 ， 并 记得 将 修改 后 的 代码 合并 到 主干 
线 上 。 这 样 的 话 ， 不 仅 可 以 轻松 解决 抒 1.0 版 本 存在 的 pug， 而 且 保证 了 主干 
已经 修复 了 这 些 bug， 当 1.1 版 本 发 布 时 就 不 会 有 同样 的 bug 存 
了 。 


说 了 这 么 多 ， 相 信 你 也 已 经 意识 到 分 支 的 重要 性 了 ， 那 么 我 们 号 上 来 学 习 
一 下 如 何在 Git 中 操作 分 文 吧 。 


分 文 的 英文 名 是 branch， 如 果 想 要 查看 当前 的 版 本 库 当 中 有 哪些 分 文 ， 可 以 
使 用 git branch 这 个 命令 ， 结 果 如 图 11.26 所 示 。 


图 11.26 查看 所 有 分 支 

由 于 目前 LBSTest 项 目 中 还 没有 创建 过 任何 分 支 ， 因 此 只 有 一 个 master 分 支 
存在 ， 这 也 就 是 前 面 所 说 的 主干 线 。 接 下 来 我 们 尝试 去 创建 一 个 分 支 ， 命 
EA 


git branch version1.0 


这 样 就 创建 了 一 个 名 为 version1.0 的 分 支 ， 我 们 再 次 输入 git branch 这 个 命 
令 来 检查 一 下 ， 结 果 如 图 11.27 所 示 。 


$ git branch 


图 11.27 ”再 次 查看 所 有 分 文 
可 以 看 到 ， 果 然 有 一 个 叫 作 version1.0 的 分 文 出 现 了 。 你 会 发 现 ，master 分 文 
的 前 面 有 一 个 “*” 号 ， 说 明 目 前 我 们 的 代码 还 是 在 master 分 支 上 的 ， 那 么 怎 


样 才能 切换 到 version1.0 这 个 分 支 上 呢 ? 其 实 也 很 简单 ， 只 需要 使 用 
checkout 命令 即 可 ， 如 下 所 示 : 


git checkout version1.0 


再 次 输入 git branch 来 进行 检查 ， 结 末 如 图 11.28 所 示 。 


$ git branch 
master 


图 11.28 ”查看 切换 分 支 后 的 结果 
可 以 看 到 ， 我 们 已 经 把 代码 成 功 切换 到 version1.0 这 个 分 文 上 了 。 


需要 注意 的 是 ， 在 version1.0 分 支 上 修改 并 提交 的 代码 将 不 会 影响 到 master 分 
支 。 同 样 的 道理 ， 在 master 分 支 上 修改 并 提交 的 代码 也 不 会 影响 到 version1.0 
分 文 。 因 此 ， 如 采 我 们 在 version1.0 分 文 上 修复 了 一 个 bug， 在 master 分 文 上 
这 个 bug 仍 然 是 存在 的 。 这 时 将 修改 的 代码 一 行 行 复制 到 master 分 文 上 显然 
不 是 一 种 聪明 的 做 法 ， 最 好 的 办 法 就 是 使 用 merge 命令 来 完成 合并 操作 ， 如 
下 所 示 : 


git checkout master 
git merge version1.0 


仅仅 这 样 简单 的 两 行 命令 ， 束 可 以 把 在 version1.0 分 文 上 修改 并 提交 的 内 容 
合并 到 master 分 文 上 了 。 当 然 ， 在 合并 分 文 的 时候 还 有 可 能 出 现代 码 冲 突 的 


情况 ， 这 个 时 候 你 焉 需要 静 下 心 来 慢 慢 地 找 出 并 解决 这 些 冲 突 ，Git 在 这 里 
束 无 法 帮助 你 了 。 


最 后 ， 当 我 们 不 再 需要 version1.0 这 个 分 文 的 时 候 ， 可 以 使 用 如 下 命令 将 这 
个 分 支 删 除 挥 : 


git branch -D version1.0 


11.5.2 “与 远程 版 本 库 协 作 


可 以 这 样 说 ， 如 采 你 是 一 个 人 在 开发 ， 那 么 使 用 版 本 控制 工具 融 远 远 无 法 
发 挥 出 它 真 正 强 大 的 功能 。 没 错 ， 所 有 版 本 控制 工具 最 重要 的 一 个 特点 束 
征 可 以 使 用 它 来 进行 团队 合作 开发 。 每 个 人 的 电脑 上 都 会 有 一 份 代码 ， 妆 
团队 的 某 个 成 员 在 上 自己 的 电脑 上 编写 完成 了 某 个 功能 后 ， 束 将 代码 提交 到 
服务 器 ， 其 他 的 成 员 只 需要 将 服务 器 上 的 代码 同步 到 本 地 ， 就 能 保证 整个 
团队 所 有 人 的 代码 都 相同 。 这 样 的 话 ， 每 个 团队 成 员 就 可 以 各 司 其 职 ， 大 
家 共同 来 完成 一 个 较为 庞大 的 项 目 。 


那么 如 何 使 用 Git 来 进行 团队 合作 开发 呢 ? 这 殊 需 要 有 一 个 远程 的 版 本 库 ， 
团队 的 每 个 成 员 都 从 这 个 版 本 库 中 获取 到 最 原始 的 代码 ， 然 后 各 目 进行 开 
发 ， 并 且 以 后 每 次 提交 的 代码 都 同步 到 远程 版 本 库 上 束 可 以 了 。 男 外 ， 团 
队 中 的 每 个 成 员 最 好 都 要 养 成 经 常 从 版 本 库 中 获取 最 新 代码 的 习惯 ， 不 然 
的 话 ， 大 家 的 代码 束 很 有 可 能 经 第 出 现 冲 突 。 


比如 说 现在 有 一 个 远程 版 本 库 的 Git 地 址 是 https://github.com/example/test.git 
， 就 可 以 使 用 如 下 的 命令 将 代码 下 载 到 本 地 : 


git clone https://github.com/example/test.git 


之 后 你 在 这 份 代码 的 基础 上 进行 了 一 些 修改 和 提交 ， 那 么 怎样 才能 把 本 地 
修改 的 内 容 同步 到 远程 版 本 库 上 呢 ? 这 吏 需 要 借助 push 命令 来 完成 了 ， 用 
法 如 下 所 示 : 


git push origin master 


其 中 origin 部 分 指定 的 是 远程 版 本 库 的 Git 地 址 ，master 部 分 指定 的 是 同步 
到 哪 一 个 分 文 上 ， 上 壕 命 令 承 完成 了 将 本 地 代码 同步 到 
https://github.com/example/test.git 这 个 版 本 库 的 master 分 文 上 的 功能 。 


知道 了 将 本 地 的 修改 同步 到 远程 版 本 库 上 的 方法 ， 接 下 来 我 们 看 一 下 如 何 
将 远程 版 本 库 上 的 修改 同步 到 本 地 。Git 提 供 了 两 种 命令 来 完成 此 功能 ， 分 
别 是 fetch 和 pull ，fetch 的 语法 规则 和 push 是 差不多 的 ， 如 下 所 示 : 


git fetch origin master 


执行 这 个 命令 后 ， 融 会 将 远程 版 本 库 上 的 代码 同步 到 本 地 ， 不 过 同步 下 来 
的 代码 并 不 会 合并 到 任何 分 支 上 去 ， 而 是 会 存放 到 一 个 origin/master pa 
上 ， 这 时 我 们 可 以 通过 diff 命令 来 查看 远程 版 本 库 上 到 底 修 改 了 哪些 东 


昱 


git diff origin/master 


之 后 再 调用 merge 命令 将 origin/master 分 支 上 的 修改 合并 到 主 分 支 上 即 
可 ， 如 下 所 示 : 


git merge origin/master 


而 pull 命 令 则 是 相当 于 将 fetch 和 merge 这 两 个 命令 放 在 一 起 执行 了 ， 它 可 以 
从 远程 版 本 库 上 获取 最 新 的 代码 并 且 合 并 到 本 地 ， 用 法 如 下 所 示 : 


git pull origin master 


也 许 你 现在 对 远程 版 本 库 的 使 用 还 是 感觉 比较 抽象 ， 没 关系 ， 因 为 暂时 我 
们 只 是 了 解 了 一 下 命令 的 用 法 ， 还 没 进行 实践 ， 在 第 14 章 当中 ， 你 将 会 对 
远程 版 本 库 的 用 法 有 更 深 一 层 的 认识 。 


11.6 小结 与 扩 评 


不 得 不 说 ， 本 章 中 学 到 的 知识 应 该 还 算是 蛮 有 趣 的 吧 ? 在 这 次 的 Android 特 
色 开 发 环节 中 ， 我 们 主要 学 习 了 基于 位 置 服务 的 工作 原理 和 用 法 ， 借 助 百 
度 提 供 的 LBS SDK， 我 们 可 以 随时 确定 自己 当前 位 置 的 经 纬度 ， 并 且 还 能 
获取 到 具体 的 省 、 市 、 区 、 街 道 等 地 址 。 之 后 又 学 习 了 百度 地 图 的 用 法 ， 

不 仅 成 功 地 将 地 图 信息 显示 了 出 来 ， 还 综合 利用 了 前 面 所 学 到 的 定位 技术 
实现 了 一 个 较为 完整 的 例子 。 


除了 基于 位 置 的 服务 之 外 ， 本 章 Git 时 间 中 继续 对 Git 的 用 法 进行 了 更 深 一 步 
的 探 完 ， 使 得 我 们 对 分 文 和 远程 版 本 库 的 使 用 都 有 了 一 定 层 次 的 了 解 。 


那么 关于 Android 特 色 开 发 的 内 容 就 讲 到 这 里 ， 下 一 章 中 我 们 将 会 学 习 
Android 5.0 系 统 中 新 增 的 一 套 全 新 的 知识 点 Mtaterial Design。 


Material 


第 12 章 ”最 佳 的 UI 体 双 
Design 实 战 


其 实 长 久 以 来 ， 大 多 数 人 都 认为 Android 系 统 的 UI 并 不 算 美 观 ， 至 少 没有 

iOS 系 统 的 美观 。 以 至 于 很 多 IT 公司 在 进行 应 用 界面 设计 的 时 候 ， 为 了 保证 
双 平 台 的 统一 性 ， 强 制 要 求 Android 响 的 界面 风格 必须 和 iOS 端 一 致 。 这 种 
情况 在 现实 工作 当中 实在 十 太 和 常见 了 ， 虽 然 我 认为 这 是 非常 不 合理 的 。 因 
为 对 于 一 般 用 户 来 说 ， 他 们 不 太 可 能 会 在 两 个 操作 系统 上 分 别 去 使 用 同一 
个 应 用 ， 但 是 却 必定 会 在 同一 个 操作 系统 上 使 用 不 同 的 应 用 。 因 此 ， 同 一 
个 操作 系统 中 各 个 应 用 之 间 的 界面 统一 性 要 远 比 一 个 应 用 在 双 平 台 的 界面 
统一 性 重要 得 多 ， 只 有 这 样 ， 才 能 给 使 用 者 带 来 更 好 的 用 户 体 验 。 


但 问题 在 于 ，Android 标 准 的 界面 设计 风格 并 不 是 特别 被 大 从 所 接 受 ， 很 多 
公司 都 觉得 目 己 完全 可 以 设计 出 更 加 好 看 的 界面 ， 从 而 导致 Android 平 台 的 
界面 风格 长 期 难以 得 到 统一 。 为 了 解决 这 个 问题 ， 谷 歌 也 是 你 出 了 杀手 
钢 ， 在 2014 年 Google WO 大 会 上 重 磅 推出 了 一 僚 全 新 的 界面 设计 语言 
Material Design ° 


本 章 我 们 就 将 对 Material Design 进 行 一 次 深入 的 学 习 。 


12.1 什么 是 Material Design 


Material Design 是 由 谷歌 的 设计 工程 师 们 基于 传统 优秀 的 设计 原则 ， 结 合 丰 
富 的 创意 和 科学 技术 所 发 明 的 一 套 全 新 的 界面 设计 语言 ， 包 含 了 视觉 、 运 
动 、 互 动 歼 果 等 特性 。 那 么 谷歌 任 什 么 认为 Material Design 就 能 解决 Android 
平台 界面 风格 不 统一 的 问题 呢 ? 一 言 以 蔽 之 ， 好 看 ! 


没 销 ， 这 次 谷歌 在 界面 设计 上 确实 是 下 足 了 功夫 ， 很 多 媒体 评论 ，Material 
Design 的 出 现 使 得 Android 首 次 在 UI 方面 超越 了 iOS。 按 照 正常 的 思维 来 想 ， 
如 果 各 个 公司 都 无 法 设计 出 比 Material Design 更 出 色 的 界面 风格 ， 那 么 它们 
驶 应 该 理所当然 地 使 用 Material Design 来 设计 界面 ， 从 而 也 就 能 解决 Android 
平台 界面 风格 不 统一 的 问题 了 。 


为 了 做 出 表率 ， 合 歌 从 Android 5.0 系 统 开 始 ， 就 将 所 有 内 置 的 应 用 都 使 用 
Material Design 风 格 来 进行 设计 。 这 里 我 随便 截 了 两 张 图 ， 你 可 以 先 欣 赏 一 
下 ， 如 图 12.1 所 示 。 
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图 12.1 使 用 Material Design 设 计 的 应 用 


其 中 ， 左 边 的 应 用 是 Play Store， 右 边 的 应 用 是 YouTube。 可 以 看 出 ， 它 们 的 
界面 都 十 分 美观 ， 而 它们 正 是 使 用 Material Design 来 进行 设计 的 。 


不 过 ， 在 重 磅 推出 之 后 ，Material Design 的 普及 程度 却 不 能 说 是 特别 理想 。 
因为 这 只 是 一 个 推荐 的 设计 规范 ， 主 要 是 面向 UI 设计 人 员 的 ， 而 不 是 面向 
开发 者 的 。 很 多 开发 者 可 能 根本 就 搞 不 清楚 什么 样 的 界面 和 效果 才 叫 
Material Design， 就 算 搞 清楚 了 ， 实 现 起 来 也 会 很 费劲 ， 因 为 不 少 Material 
Design 的 效果 是 很 难 实现 的 ， 而 Android 中 却 几乎 没有 提供 相应 的 API 支 持 ， 
一 切 都 要 靠 开 发 者 自己 从 零 写 起 。 


谷歌 当然 也 意识 到 了 这 个 问题 ， 于 是 在 2015 年 的 Google WO 大 会 上 推出 了 一 
个 Design Support 库 ， 这 个 库 将 Material Design 中 最 具 代表 性 的 一 些 控件 和 效 
采 进 行 了 封装 ， 使 得 开发 者 在 即使 不 了 解 Material Design 的 情况 下 也 能 非常 
轻松 地 将 自己 的 应 用 Material 化 。 本 章 中 我 们 就 将 对 Design Support 这 个 库 进 


行 深入 的 学 习 ， 并 且 配 合 一 些 其 他 的 控件 来 完成 一 个 优秀 的 Material Design 
应 用 。 


新 建 一 个 MaterialTest 项 目 ， 然 后 我 们 蕊 上 开始 吧 1 


12.2 Toolbar 


Toolbar 将 会 是 我 们 接触 的 第 一 个 Material 控 件 。 虽 说 对 于 Toolbar 你 暂时 应 该 
还 是 比较 陌生 的 ， 但 是 对 于 它 的 男 一 个 相关 控件 ActionBar， 你 就 应 该 有 点 
熟悉 了 。 


回忆 一 下 ， 我 们 曾经 在 3.4.1 小 节 为 了 使 用 一 个 目 定义 的 标题 栏 ， 而 把 系统 
原生 的 ActionBar 隐 藏 掉 。 没 错 ， 每 个 活动 最 顶部 的 那个 标题 栏 其 实 就 是 
ActionBar， 之 前 我 们 编写 的 所 有 程序 里 一 直 都 有 ActionBar 的 屿 影 。 


不 过 ActionBar 由 于 其 设计 的 原因 ， 被 限定 只 能 位 于 活动 的 顶部 ， 从 而 不 能 
实现 一 些 Material Design 的 效果 ， 因 此 官方 现在 已 经 不 再 建议 使 用 ActionBar 
了 。 那 么 本 书 中 我 也 束 不 准备 再 介绍 ActionBar 的 用 法 了 ， 而 是 直接 讲解 现 
在 更 加 推荐 使 用 的 Toolbar 。 


Toolbar 的 强大 之 处 在 于 ， 它 不 仅 继 承 了 ActionBar 的 所 有 功能 ， 而 且 灵 活性 
很 高 ， 可 以 配合 其 他 控件 来 完成 一 些 Material Design 的 效果 ， 下 面 我 们 就 来 
具体 学 习 一 下 。 


首先 你 要 知道 ， 任 何 一 个 新 建 的 项 目 ， 默 认 都 是 会 显示 ActionBar 的 ， 这 个 
想必 你 已 经 见识 过 太 多 次 了 。 那 么 这 个 ActionBar 到 底 是 从 哪里 来 的 呢 ? 其 
实 这 是 根据 项 目 中 指定 的 主题 来 显示 的 ， 打 开 AndroidManifest.xml 文 件 看 一 
卜 ， 如 下 所 示 : 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 


可 以 看 到 ， 这 里 使 用 android:theme 属性 指定 了 一 个 AppTheme 的 主题 。 那 
么 这 个 AppTheme 又 是 在 哪里 定义 的 呢 ? 打开 res/values/styles.xml 文 件 ， 代 码 
如 下 所 示 : 


<resources> 


<!-- Base application theme. --> 

<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar"> 
<!-- Customize your theme here. --> 
<item name="colorPrimary">@color/colorPrimary</item> 
<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 


<item name="colorAccent">@color/colorAccent</item> 
</style> 


</resources> 


这 里 定义 了 一 个 叫 AppTheme 的 主题 ， 然 后 指定 它 的 parent 主 题 是 
Theme.AppCompat.Light.DarkActionBar。 这 个 DarkActionBar 是 一 个 深 色 的 
ActionBar 主 题 ， 我 们 之 前 所 有 的 项 目 中 目 带 的 ActionBar 瓯 是 因为 指定 了 这 
个 主题 才 出 现 的 。 


而 现在 我 们 准备 使 用 Toolbar 来 奉 代 ActionBar， 因 此 需要 指定 一 个 不 认 
ActionBar 的 主题 ， 通 常 有 Theme.AppCompat.NoActionBar 和 
Theme.AppCompat.Light.NoActionBar 这 两 种 主题 可 选 。 其 中 
Theme.AppCompat,NoActionBar 表 示 深 色 主 题 ， 它 会 将 界面 的 主体 颜色 设 成 
深 色 ， 陪 衬 颜 色 设 成 淡色 。 而 Theme.AppCompat.Light,NoActionBar 表 示 淡 
色 主 题 ， 它 会 将 界面 的 主体 颜色 设 成 淡色 ， 陪 村 颜色 设 成 深 色 。 有 具体 的 歼 
果 你 可 以 目 己 动手 试 一 试 ， 这 里 由 于 我 们 之 前 的 程序 一 直 都 是 以 淡色 为 主 
的 ， 那 么 我 束 选 用 淡色 主题 了 7， 如 下 所 示 : 


<resources> 


<!-- Base application theme. --> 

<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar"> 
<!-- Customize your theme here. --> 
<item name="colorPrimary">@color/colorPrimary</item> 
<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 


<item name="colorAccent">@color/colorAccent</item> 
</style> 


</resources> 


然后 观察 一 下 AppTheme 中 的 属性 重 写 ， 这 里 重 写 了 colorPrimary 、 
colorPrimaryDark 和 colorAccent 这 3 个 属性 的 颜色 。 那 么 这 3 个 属性 分 别 代 


表 着 什么 位 置 的 颜色 呢 ? 我 用 语言 比较 难 描述 清楚 
解 一 下 吧 ， 如 图 12.2 所 示 。 
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图 12.2 各 属性 指定 颜色 的 位 置 


可 以 看 到 ， 每 个 属性 所 指定 颜色 的 位 置 直 搂 一 目 了 然 了 。 
除了 上 壕 3 个 属性 之 外 ， 我 们 还 可 以 通过 textcolorPrimary 、 
windowBackground navigationBarcolor 等 属性 来 控制 更 多 位 置 的 颜色 。 不 
过 唯 独 colorAccent 这 个 属性 比较 难 理解 ， 它 不 只 是 用 来 指定 这 样 一 个 按钮 
的 颜色 ， 而 是 更 多 表达 了 一 个 强调 的 意思 ， 比 如 一 些 控件 的 选中 状态 也 会 
使 用 colorAccent 的 颜色 


， 还 是 通过 一 张 图 来 理 


现在 我 们 已 经 将 ActionBar 隐 藏 起 来 了 ， 那 么 接 下 来 看 一 看 如 何 使 用 Toolbar 
来 蔡 代 ActionBar。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat .Light" /> 


</FrameLayout> 


虽然 这 段 代码 不 长 ， 但 是 里 面 着 实 有 不 少 技术 点 是 需要 我 们 去 仔细 琢磨 一 


下 的 。 首 移 看 一 下 第 2 行 ， 这 里 使 用 xmlns:app 指定 了 一 个 新 的 命名 空间 。 
思考 一 下 ， 正 是 由 于 每 个 布局 文件 都 会 使 用 xmlns:android 来 指定 一 个 命名 
空间 ， 因 此 我 们 才能 一 直 使 用 android:id 、android: layout_width 等 写 
法 ， 那 么 这 里 指定 了 xmlns:app ， 也 残 是 说 现在 可 以 使 用 app:attribute 这 
样 的 写法 了 。 但 是 为 什么 这 里 要 指定 一 个 xmlns:app 的 命名 空间 呢 ? 这 是 由 
于 Material Design 是 在 Android 5.0 系 统 中 才 出 现 的 ， 而 很 多 的 Material 属 性 在 
5.0 之 前 的 系统 中 并 不 存在 ， 那么 为 了 能 够 兼容 之 前 的 老 系统 ， 我 们 就 不 能 

使 用 android:attribute 这 样 的 写法 了 ， 而 是 应 该 使 用 app:attribute 。 


接 下 来 定义 了 一 个 Toolbar 控 件 ， 这 个 控件 是 由 appcompat-v7 库 提供 的 。 这 里 
我 们 给 Toolbar 指 定 了 一 个 id， 将 它 的 宽度 设置 为 natch_parent ， 高 度 设置 为 
actionBar 的 高 度 ， 背 景色 设置 为 colorPrimary。 不 过 下 面 的 部 分 就 稍微 有 点 
难 理解 了 ， 由 于 我 们 刚才 在 styles.xml 中 将 程序 的 主题 指定 成 了 淡色 主题 ， 
因此 Toolbar 现 在 也 是 淡色 主题 ， 而 Toolbar 上 面 的 各 种 元 素 就 会 自动 使 用 深 
色 系 ， 这 是 为 了 和 主体 闫 色 区 别 开 。 但 是 这 个 效果 看 起 来 就 会 很 差 ， 之 前 
使 用 ActionBar 时 文字 都 是 白色 的 ， 现 在 变 成 黑色 的 会 很 难看 。 那 么 为 了 能 
让 Toolbar 单 独 使 用 深 色 主题 ， 这 里 我 们 使 用 android:theme 属性 ， 将 Toolbar 
的 主题 指定 成 了 ThemeOverlay.AppCompat.Dark.ActionBar。 但 是 这 样 指 定 完 
Wi 出 现 新 的 问题 ， 如 果 Toolbar 中 有 菜单 按钮 (我 们 在 2.2.5 小 节 中 
过 ) ， 那 么 弹出 的 菜单 项 也 会 变 成 深 色 主 题 ， 这 样 就 再 次 变 得 十 分 难 
看 于 是 这 里 使 用 了 app:popupTheme 属性 单独 将 弹出 的 表单 项 指定 成 了 淡 
色 主 题 。 之 所 以 使 用 app:popupTheme ， 是 因为 popupTheme 这 个 属性 是 在 


Android 5.0 系 统 中 新 增 的 ， 我 们 使 用 app:popupTheme 的 话 就 可 以 兼容 
Android 5.0 以 下 的 系统 了 。 


如 采 你 觉得 上 面 的 描述 很 绕 的 话 ， 可 以 目 己 动手 做 一 做 试验 ， 看 看 不 指定 
上 述 主 题 会 定 什么 样 的 效果 ， 这 样 你 会 理解 得 更 加 深刻 。 


写 完 了 布局 ， 接 下 来 我 们 修改 MainActivity， 代 码 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar); 
setSupportActionBar (toolbar); 

} 


这 里 关键 的 代码 只 有 两 句 ， 首 先 通过 findviewById() 得 到 Toolbar 的 实例 ， 
然后 调用 setsupportActionBar() 方法 并 将 Toolbar 的 实例 传 入 ， 这 样 我 们 就 
做 到 既 使 用 了 Toolbar， 又 让 它 的 外 观 与 功能 都 和 ActionBar 一 致 了 。 


现在 运行 一 下 程序 ， 效 果 如 图 12.3 所 示 。 
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图 12.3 ”Toolbar 的 标准 界面 


这 个 标题 栏 我 们 再 熟悉 不 过 了 ， 虽 然 看 上 去 和 之 前 的 标题 栏 没什么 两 样 ， 
但 其 实 它 已 经 是 Toolbar 而 不 是 ActionBar 了 。 因 此 它 现 在 也 具备 了 实现 
Material Design 效 有 果 的 能 力 ， 这 个 我 们 在 后 面 就 会 学 到 。 


接 下 来 我 们 再 学 习 一 些 Toolbar 比 较 第 用 的 功能 吧 ， 比 如 修改 标题 栏 上 显示 
的 文字 内 容 。 这 上 段 文字 内 容 是 在 AndroidManifest,xml 中 指定 的 ， 如 下 所 示 : 


<application 

android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity 

android:name=" .MainActivity" 

android:label="Fruits"> 


</activity> 
</application> 


(el 


这 里 给 activity 增加 了 一 个 android:1abel 属性 ， 用 于 指定 在 Toolbar 中 显示 
的 文字 内 容 ， 如 果 没 有 指定 的 话 ， 会 默认 使 用 application 中 指定 的 label 
内 容 ， 也 束 是 我 们 的 应 用 名 称 。 


不 过 只 有 一 个 标题 的 Toolbar 看 起 来 太 单 调 了 ， 我 们 还 可 以 再 添加 一 些 
action 按钮 来 让 Toolbar 更 加 丰富 一 些 ， 这 里 我 提前 准备 了 几 张 图 片 来 作为 
按钮 的 图 标 ， 将 它们 放 在 了 drawable-xxhdpi 目 好 下 。 现 在 右 击 res 目 录 

一 New Directory， 创 建 一 个 menu 文 件 夹 。 然 后 右 击 menu 文 件 夹 

New 一 Menu resource file， 创 建 一 个 toolbar.xml 文 件 ， 并 编写 如 下 代码 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto"> 
<item 
android:id="@+id/backup" 
android:icon="@drawable/ic_backup" 
android:title="Backup" 
app:showAsAction="always" /> 
<item 
android:id="@+id/delete" 
android:icon="@drawable/ic_delete" 
android:title="Delete" 
app:showAsAction="ifRoom" /> 
<item 
android:id="@+id/settings" 
android:icon="@drawable/ic_settings" 
android:title="Settings" 
app:showAsAction="never" /> 
</menu> 


可 以 看 人 到， 我 们 通过 <item> 标签 来 定义 action 按钮 ，android:id 用 于 指定 
按钮 的 id，android:icon 用 于 指定 按钮 的 图 标 ，android:title 用 于 指定 按 


和 包 肘 叉 学 


接着 使 用 app: showAsAction 来 指定 按钮 的 显示 人 位置， 之 所 以 这 里 再 次 使 用 
了 app 命 名 空间 ， 同 样 是 为 了 能 够 兼容 低 版 本 的 系统 。showAsAction 主要 有 
以 下 几 种 值 可 选 : always 表 示 永 远 显 示 在 Toolbar 中 ， 如 采 屏 幕 空 间 不 够 则 不 
显示 ; iftRoom 表 示 屏 幕 空 间 足 够 的 情况 下 显示 在 Toolbar 中 ， 不 够 的 话 了 驶 显 
示 在 菜单 当中 ; never 则 表示 永远 显示 在 荣 单 当中 。 注 意 ，Toolbar 中 的 action 
按钮 只 会 显示 图 标 ， 荣 单 中 的 action 按 钮 只 会 显示 文字 。 


接 下 来 的 做 法 就 和 2.2.5 小 节 中 的 完全 一 致 了 ， 修 改 MainActivity 中 的 代码 ， 
如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


public boolean onCreateOptionsMenu(Menu menu) 区 
getMenuInflater().inflate(R.menu.toolbar, menu); 
return true,; 


} 


Q@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case R.id.backup: 
Toast.makeText(this, "You clicked Backup", Toast .LENGTH_SHORT). 
Show( ); 
break; 
case R.id.delete: 
Toast.makeText(this, "You clicked Delete", Toast.LENGTH_SHORT). 
Show( ); 
break; 
case R.id.settings: 
Toast.makeText(this, "You clicked Settings", Toast.LENGTH_SHORT). 
Show( ); 
break; 
default: 
} 


return true,; 


非常 简单 ， 我 们 在 oncreateoptionsMenu( ) 方法 中 加 载 了 toolbarxml 这 个 荣 
单 文件 ， 然后 在 onoptionsItemselected() 方法 中 处 理 各 个 按钮 的 点 击 事 
件 。 现 在 重新 运行 一 下 程序 ， 效 果 如 图 12.4 所 示 。 


图 12.4 带 有 action 按 钮 的 Toolbar 


可 以 看 到 ，Toolbar 上 面 现 在 显示 了 两 个 action 按 钮 ， 这 是 因为 Backup 按 钮 指 
定 的 显示 位 置 是 always， Delete 按 讯 指 定 的 于 显示 位 置 是 iftRoom， 而 现在 屏幕 
空间 很 充足 ， 因 此 两 个 按钮 都 会 显示 在 Toolbar 中 。 男 外 一 个 Settings 按 钮 由 
于 指定 的 显示 位 置 是 never， 所 以 不 会 显示 在 Toolbar 中 ， 点 击 一 下 最 右边 的 
表 单 按钮 来 展开 表 单项 ， 你 就 能 找到 Settings 按 钮 了 。 男 外 这 些 action 按 钮 都 
是 可 以 响应 点 击 事件 的 ， 你 可 以 目 己 去 试 一 试 。 


好 了 ， 关 于 Toolbar 的 内 容 就 先 讲 这 么 多 吧 。 当 然 Toolbar 的 功能 还 远 远 不 只 


这 宇 ， 不 过 我 们 显然 无 法 在 一 记忆 中 就 把 所 有 的 用 法 全 部 学 完 ， 后 面 会 结 
谷 其 其 他 控 件 来 挖掘 Toolbar 的 更 多 功能 


12.3 ”滑动 菜单 


滑动 沫 单 可 以 说 是 Material Design 中 最 常见 的 效果 之 一 了 ， 在 许多 著名 的 应 
用 (如 Gmail、Google+ 等 ) 中 ， 都 有 滑动 菜单 的 功能 。 虽 说 这 个 功能 看 上 
去 好 像 挺 复杂 的 ， 不 过 借助 谷歌 提供 的 各 种 工具 ， 我 们 可 以 很 轻松 地 实现 
非常 炫 酷 的 滑动 采 单 效果 ， 那 么 我 们 马上 开始 吧 。 


12.3.1 DrawerLayout 


所 谓 的 请 动 亦 单 区 是 将 一 些 沫 单 选 项 隐藏 起 来 ， 而 不 是 放置 在 主屏 幕 上 ， 
然后 可 以 通过 滑动 的 方式 将 菜单 显示 出 米 。 这 种 方式 既 广 省 了 屏幕 空间 ， 
又 实现 了 非常 好 的 动画 效果 ， 是 Material Design 中 推荐 的 做 法 。 


不 过 如 有 果 我 们 全 靠 自 己 去 实现 上 述 功 能 的 话 ， 难 度 灵 怕 就 很 大 了 。 幸 运 的 
征 ， 谷 歌 捉 供 了 一 个 DrawerLayout 控 件 ， 借 助 这 个 控件 ， 实 现 滑动 菜单 简单 
Bah 


先 来 简单 介绍 一 下 DrawerLayout 的 用 法 吧 。 首 先 它 是 一 个 布局 ， 在 布局 中 人 允 
许 放 入 两 个 直接 子 控件 ， 第 一 个 子 控件 是 主屏 医 中 显示 的 内 容 ， 第 二 个 子 

控件 是 请 动 菜 单 中 显示 的 内 容 。 因 此 ， 我 们 就 可 以 对 activity_main.xml 中 的 

代码 做 如 下 修改 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<FrameLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat .Light" /> 


</FrameLayout> 


<TextView 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:layout_gravity="start" 
android:text="This is menu" 
android:textSize="30sp" 
android:background="#FFF" /> 


</android.support.v4.widget.DrawerLayout> 


| 


可 以 看 到 ， 这 里 最 外 层 的 控件 使 用 了 DrawerLayout， 这 个 控件 是 由 support- 
v4 库 提 供 的 。DrawerLayout 中 放置 了 两 个 直接 子 控件 ， 第 一 个 子 控件 是 
FrameLayout， 用 于 作为 主屏 幕 中 显示 的 内 容 ， 当 然 里 面 还 有 我 们 刚刚 定义 
的 Toolbar。 第 二 个 子 控件 这 里 使 用 了 一 个 TextView， 用 于 作为 消 动 末 单 中 
pi 其 实 使 用 什么 都 可 以 ，DrawerLayout 并 没有 限制 只 能 使 用 固定 


但 是 关于 第 二 个 子 控件 有 一 点 需要 注意 ， layout_gravity 这 个 属性 是 必须 
指定 的 ， 因 为 我 们 需要 告诉 DrawerLayout 滑 动 菜 单 是 在 屏幕 的 左边 还 是 右 
边 ， 指 定 left 表 示 滑 动 薪 单 在 左边 ， 指 定 right 表 示 清 动 菜 单 在 右边 。 这 里 我 
指定 了 start， 表 示 会 根据 系统 语言 进行 判断 ， 如 果 系 统 语言 是 从 左 往 右 的 ， 
比如 英语 、 汉 语 ， 滑 动 莱 单 就 在 左边 ， 如 果 系 统 语言 是 从 右 往 左 的 ， 比 如 
阿拉 伯 语 ， 清 动 薪 单 承 在 右边 。 


没 错 ， 只 需要 改动 这 么 多 就 可 以 了 ， 现 在 重新 运行 一 下 程序 ， 然 后 在 屏幕 
的 左 侧 边 缘 同 右 拖 动 ， 束 可 以 让 消 动 荣 单 显 示 出 来 了 ， 如 图 12.5 所 示 。 


24 品 12:40 


This is menu 


图 12.5 显示 滑动 菜单 界面 


然后 同 左 渭 动 菜 单 ， 或 者 点 击 一 下 菜单 以 外 的 区 域 ， 都 可 以 让 消 动 末 单 关 
闭 ， 从 而 回 到 主 界面 。 无 论 是 展示 还 是 隐藏 消 动 菜单 ， 部 是 有 非常 流畅 的 
动画 过 滤 的 。 


可 以 看 到 ， 我 们 只 是 稍微 改动 了 一 下 布局 文件 ， 束 能 实现 如 此 米 酷 的 效 
条 ， 是 不 是 觉得 挺 激动 呢 ? 不 过 现在 的 滑动 末 单 还 有 点 问题 ， 因 为 只 有 在 
屏幕 的 左 侧 边 绿 进行 拖 动 时 才能 将 菜单 拖 出 来 ， 而 很 多 用 户 可 能 根本 束 不 
知道 有 这 个 功能 ， 那 么 该 怎么 提示 他 们 呢 ? 


Material Design 建 议 的 做 法 是 在 Toolbar 的 最 左边 加 入 一 个 导航 按钮 ， 点 击 了 
按钮 也 会 将 请 动 深 单 的 内 容 展示 出 来 。 这 样 天 相当 于 给 用 户 担 供 了 两 种 打 
开 清 动 索 单 的 方式 ， 防 止 一 些 用 户 不 知道 屏幕 的 左 侧 边 绿 是 可 以 拖 动 的 。 


下 面 我 们 开始 来 实现 这 个 功能 。 首 移 我 准备 了 一 张 导 航 按 钮 的 图 标 
ic_menu.png， 将 它 放 在 了 drawable-xxhdpi 目 录 下 。 然 后 修改 MainActivity 中 
的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private DrawerLayout mDrawerLayout; 


Q@Override 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar); 
SetSupportActionBar(toolbar ) 
mDrawerLayout = (DrawerLayout ) findViewById(R.id,.drawer_layout); 
ActionBar actionBar = getSupportActionBar(); 
if (actionBar != nul1) { 
actionBar.setDisplayHomeAsUpEnabled(true); 
actionBar.setHomeAsUpIndicator(R.drawable.ic_ menu); 


QOverride 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case android.R.id.home: 
mDrawerLayout .openDrawer(GravityCompat ,START ) ， 
break; 


default: 


return true,; 


这 里 我 们 并 没有 改动 多 少 代 码 ， 自 先 调用 findviewById() 方法 得 到 了 
DrawerLayout 的 实例 ， 然 后 调用 getsupportActionBar() 方法 得 到 了 
ActionBar 的 实例 ， 虽 然 这 个 ActionBar 的 具体 实现 是 由 Toolbar 来 完成 的 。 接 
着 调用 ActionBar 的 setDisplayHomeAsUpEnabled() 方法 让 导航 按钮 显示 出 
来 ， 又 调用 了 setHomeAsupIndicator() 方法 来 设置 一 个 导航 按钮 图 标 。 实 际 
上 ，Toolbar 最 左 侧 的 这 个 按钮 就 叫 作 HomeAsUp 按 钮 ， 它 默认 的 图 标 是 一 个 
返回 的 箭头 ， 售 义 是 返回 上 一 个 活动 。 很 明显 ， 这 里 我 们 将 它 默 认 的 样式 
和 作用 都 进行 了 修改 。 

接 下 来 在 onoptionsItemselected() 方法 中 对 HomeAsUp 按 钮 的 点 击 事件 进 


行 处 理 ，HomeAsUp 按 钮 的 id 永 远 都 是 android.R.id.home 。 然 后 调用 
DrawerLayout 的 openDrawer() 方法 将 滑动 表单 展示 出 来 ， 注意 openDrawer() 


方法 要 求 传 入 一 个 Gravity 人 参数， 为 了 保证 这 里 的 行为 和 XML 中 定义 的 一 
致 ， 我 们 传 入 了 Gravitycompat .START 。 


现在 重新 运行 一 下 程序 ， 效 采 如 图 12.6 所 示 。 
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图 12.6 显示 HomeAsUp 按 钮 


可 以 看 到 ， 在 Toolbar 的 最 左边 出 现 了 一 个 导航 按钮 ， 用 户 看 到 这 个 按钮 惑 
知道 这 肯定 是 可 以 点 击 的 。 现 在 后 击 一 下 这 个 按钮 滑动 瑟 单 界面 号 会 再 
次 展示 出 来 了 。 


12.3.2 NavigationView 


目前 我 们 已 经 成 功 实现 了 滑动 菜单 功能 ， 其 中 滑动 功能 已 经 做 得 非 第 好 
了 ， 但 是 菜单 却 还 很 丑 ， 毕 况 菜 单 页 面 仅仅 使 用 了 一 个 TextView， 非 常 单 


调 。 有 对 比 才 会 有 落差 ， 我 们 看 一 下 Google+ 的 滑动 菜单 页 面 是 长 什么 样 
的 ， 如 图 12.7 所 示 。 


Profile 


人 有 People 
人 Locations 
问 Events 


Settings 


图 12.7 Google+ 的 滑动 菜单 页 面 


经 过 对 比 之 后 是 不 是 觉得 我 们 的 滑动 末 单 页 面 更 寻 了 ? 不 过 没关系 ， 优 化 
谓 动 菜单 页 面 ， 这 束 是 我 们 本 小 节 的 全 部 目标 。 


事实 上 ， 你 可 以 在 滑动 菜单 页 面 定 制 任 意 的 布局 ， 不 过 合 歌 给 我 们 提供 了 
一 种 更 好 的 方法 一 一 使 用 NavigationView 。NavigationView 是 Design Support 
库 中 提供 的 一 个 控件 ， 它 不 仅 是 严格 按照 Material Design 的 要 求 来 进行 设计 
的 ， 而 且 还 可 以 将 滑动 菜单 页 面 的 实现 变 得 非常 简 单 。 接 下 来 我 们 就 学 习 
一 下 NavigationView 的 用 法 。 


首先 ， 既 然 这 个 控件 是 Design Support 库 中 提供 的 ， 那 么 我 们 束 需 要 将 这 个 
库 引 入 到 项 目 中 才 行 。 打 开 app/build.gradle 文 件 ， 在 dependencies 闭 包 中 添 
加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: 
compile 'com.android.support:appcompat-v7:24.2.1" 
testCompile 'junit:junit:4.12"' 
compile 'com.android.support:design:24.2.1" 
compile 'de.hdodenhof:circleimageview:2.1.0' 


'libs', include: ['*.jar']) 


这 里 添加 了 两 行 依赖 关系 ， 第 一 行 就 是 Design Support 库 ， 第 二 行 是 一 个 开 
产 项 目 CircleImageView， 它 可 以 用 来 轻松 实现 图 片 圆 形 化 的 功能 ， 我 们 答 
会 就 会 用 到 它 。CircleImageView 的 项 目 主 页 地 址 是 : 
https:/github.com/hdodenhof/CircleImageView 。 


在 开始 使 用 NavigationView 之 前 ， 我 们 还 需要 提前 准备 好 两 个 东西 : menu 和 
headerLayout。menu 是 用 来 在 NavigationView 中 显示 具体 的 菜单 项 的 ， 
headerLayout 则 是 用 来 在 NavigationView 中 显示 头 部 布局 的 。 


我 们 先 来 准备 menu， 这 里 我 事先 找 了 几 张 图 片 来 作为 按钮 的 图 标 ， 并 将 它 
们 放 在 了 drawable-xxhdpi 目 录 下 。 然 后 右 击 menu 文 件 夹 New 一 Menu 
resource file， 创 建 一 个 nav_menu.xml 文 件 ， 并 编写 如 下 代码 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<group android:checkableBehavior="single"> 
<item 
android 
android 
android 
<item 


:id="@+id/nav_call" 
:icon="@drawable/nav_call" 


:title="Call" /> 


android 
android 
android 
<item 
android 
android 
android 
<item 
android 
android 
android 
<item 
android 
android 
android 


</group> 


</menu> 


:id="@+id/nav_friends" 
:icon="@drawable/nav_friends" 
:title="Friends" 


/> 


:id="@+id/nav_location" 
:icon="@drawable/nav_location" 
:title="Location" 


/> 


:id="@+id/nav_mail" 
:icon="@drawable/nav_mail" 
:title="Mail" 


/> 


:id="@+id/nav_task" 
:icon="@drawable/nav_task" 
:title="Tasks" 


/> 


| | 


我 们 首先 在 <menu> 中 骸 套 了 一 个 <group> 标签 ， 然 后 将 group 的 
checkableBehavior 属性 指定 为 single 。 group 表 示 一 个 组 ， 
checkableBehavior 指定 为 single 表示 组 中 的 所 有 菜单 项 只 能 单 选 人 


那么 下 面 我 们 来 看 一 下 这 些 来 单项 吧 。 这 里 一 共 定 义 了 5 个 item， 分 别 使 用 
android:id 属性 指定 菜单 项 的 id，android:icon 属性 指定 菜单 项 的 图 标 ， 
android:title 属性 指定 菜单 项 显示 的 文字 。 就 是 这 么 简单 ， 现 在 我 们 已 经 
把 menu 准 备 好 了 。 


接 下 来 应 该 准备 headerLayout 了， 这 是 一 个 可 以 随意 定制 的 布局 ， 不 过 我 并 
不 想 将 它 做 得 太 复杂 。 这 里 人 简单 起 见 ， 我 们 就 在 headerLayout 中 放置 头像 、 
用 户 名 、 邮 箱 地 址 这 3 项 内 容 吧 。 


说 到 头像 ， 那 我 们 还 需要 再 准备 一 张 图 片 ， 这 里 我 找 了 一 张 宠物 图 片 ， 并 
巴 它 放 在 了 drawable-xxhdpi 目 未 下 。 另 外 这 张 图 片 最 好 是 一 张 正方 形 图 片 ， 
因为 竺 会 我 们 会 把 它 圆 形 化 。 然 后 右 击 layout 文 件 夹 ~New 一 Layout resource 
file， 创 建 一 个 nav_headerxml 文 件 。 修 改 其 中 的 代码 ， 如 下 所 示 : 


tr 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="180dp" 
android:padding="10dp" 
android:background="?attr/colorPrimary"> 


<de.hdodenhof .circleimageview.CircleImageView 
android:id="@+id/icon_image" 
android:layout_width="70dp" 
android:layout_height="70dp" 
android:src="@drawable/nav_icon" 
android:layout_centerInParent="true" /> 


<TextView 
android:id="@+id/mail" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_alignParentBottom="true" 
android:text="tonygreendev@gmail.com" 
android:textColor="#FFF" 
android:textSize="14sp" /> 


<TextView 
android:id="@+id/username" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_above="@id/mail" 
android:text="Tony Green" 
android:textColor="#FFF" 
android:textSize="14sp" /> 


</RelativeLayout> 


(| 


可 以 看 到 ， 布 局 文件 的 最 外 层 是 一 个 RelativeLayout， 我 们 将 它 的 宽度 设 为 
match_parent ， 高 度 设 为 180dp， 这 是 一 个 NavigationView 比 较 适 合 的 高 
度 ， 然 后 指定 它 的 背景 色 为 colorPrimary 。 


在 RelativeLayout 中 我 们 放置 了 3 个 控件 ，CircleImageView 是 一 个 用 于 将 图 片 
圆 形 化 的 控件 ， 它 的 用 法 非常 答 单 ， 基 本 和 ImageView 是 完全 一 样 的， 这 里 
给 它 指定 了 一 张 图 片 作为 头像 ， 然 后 设置 为 届 中 显示 。 另 外 两 个 TextView 分 
别 用 于 显示 用 户 名 和 邮箱 地 址 ， 它 们 都 用 到 了 一 些 RelativeLayout 的 定位 属 
性 ， 相 信和 肯定 难 不 倒 你 吧 ? 


现在 menu 和 headerLayout 都 准备 好 了 ， 我 们 终于 可 以 使 用 NavigationView 
了 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<FrameLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat Light” /> 


</FrameLayout> 


<android,.support.design.widget.NavigationView 
android:id="@+id/nav_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:layout_gravity="start" 
app:menu="@menu/nav_menu" 
app:headerLayout="@layout/nav_header "/> 


</android.support.v4.widget.DrawerLayout> 


可 以 看 到 ， 我 们 将 之 前 的 TextView 换 成 了 NavigationView， 这 样 请 动 荣 单 中 
显示 的 内 容 也 就 变 成 NavigationView 了 “。 这 里 又 通过 app:menu 和 


app:headerLayout 属性 将 我 们 刚才 准备 好 的 menu 和 headerLayout 设 置 了 进 
去 ， 这 样 NavigationView 就 定义 完成 了 。 


NavigationView 虽 然 定义 完成 了 ， 但 是 我 们 还 要 去 处 理 沫 单项 的 点 击 事件 才 
行 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private DrawerLayout mDrawerLayout; 


Q@override 
protected void onCreate(Bundle SavedInstanceState) { 
Super .onCreate(SavedInstanceState ) 
setcontentView(R.1layout.activity_main); 
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar); 
setSupportActionBar (toolbar ); 
mDrawerLayout = (DrawerLayout) findViewById(R.id,.drawer_layout); 
NavigationView navView = (NavigationView) findViewById(R.id.nav_view); 
ActionBar actionBar = getSupportActionBar(); 
if (actionBar != null) { 
actionBar.setDisplayHomeAsUpEnabled(true); 
actionBar.setHomeAsUpIndicator(R.drawable.ic_ menu); 


} 


navView.setCheckedItem(R.id.nav_call); 
navView.setNavigationItemSelectedListener(new NavigationView.OnNavigation 
ItemSelectedListener() { 
Q@Override 
public boolean onNavigationItemSelected(MenuItem item) { 
mDrawerLayout.closeDrawers(); 
return true,; 


代码 还 是 比较 人 简单 的 ， 这 里 首先 获取 到 了 NavigationView 的 实例 ， 然 后 调用 
它 的 setcheckedItem( ) 方法 将 Call 表 单项 设置 为 默认 选中 。 接 着 调用 了 
SethNavigationttenSelected rstenert) 方法 来 设置 一 个 菜单 项 选中 事件 的 
监听 器 ， 当 用 户 点 击 了 任意 菜单 项 时 ， 束 会 回调 到 
onNavigationItemSelected() 方法 中 。 我 们 可 以 在 这 个 方法 中 写 相 应 的 逻辑 
处 理 ， 不 过 这 里 我 并 没有 附加 任何 逻辑 ， 只 是 调用 了 DrawerLayout 的 
closeDrawers() 方法 将 滑动 菜单 关闭，j 这 也 是 是 合情合理 的 做 法 。 


现在 可 以 重新 运行 一 下 程序 了 ， 点 击 一 下 Toolbar 左 侧 的 导航 按钮 ， 效 果 如 
图 12.8 所 示 。 


证 


Tony Green 
tonygreendevOgmaillcom 


图 12.8 ” NavigationView 界 面 

怎么 样 ? 这 样 的 滑动 菜单 页 面 ， 你 无 论 如 何 也 不 能 说 它 丑 了 吧 ? Material 
Design 的 魅力 就 在 这 里 ， 它 真 的 是 一 种 非常 美观 的 设计 理念 ， 只 要 你 按照 它 
的 各 种 规范 和 建议 来 设计 界面 ， 最 终 做 出 来 的 程序 就 是 特别 好 看 的 。 


相信 你 对 现在 做 出 来 的 效果 也 一 定 十 分 满意 吧 ? 不 过 不 要 满足 于 现状 ， 后 
面 我 们 会 实现 更 加 炫 酷 的 效 末 。 跟 紧 脚 步 ， 继 续 学 习 。 


12.4 ”悬浮 按钮 和 可 交互 提示 


立 面 设计 是 Material Design 中 一 条 非常 重要 的 设计 思想 ， 也 就 是 说 ， 按 昭 
Material Design 的 理念 ， 应 用 程序 的 界面 不 仅仅 只 是 一 个 平面 ， 而 应 该 是 有 
立体 效 有 果 的 。 在 官方 给 出 的 示例 中 ， 最 简单 旦 最 具 代 表 性 的 立 面 设计 就 是 


巧 浮 按钮 了 ， 这 种 按钮 不 属于 主 界面 平面 的 一 部 分 ， 而 征 位 于 另外 一 个 维 
度 的 ， 因 此 就 会 给 人 一 种 巧 浮 的 感觉 。 


本 世 中 我 们 会 对 这 个 巧 浮 按钮 的 效果 进行 学 习 ， 另 外 还 会 学 习 一 种 可 交互 
式 的 提示 工具 。 关 于 提示 工具 ， 我 们 之 前 一 直 都 是 使 用 的 Toast， 但 是 Toast 
只 能 用 于 告知 用 户 某 某 事情 已 经 发 生 了 ， 用 户 却 不 能 对 此 做 出 任何 的 啊 
应 ， 那 么 今天 我 们 就 将 在 这 一 方面 进行 扩展 。 


12.4.1 FloatingActionButton 


FloatingActionButton 是 Design Support 库 中 提供 的 一 个 控件 ， 这 个 控件 可 以 
帮助 我 们 比较 轻松 地 实现 莫 浮 按钮 的 效 采 。 其 实在 之 前 的 图 12.2 中 ， 我 们 就 
已 经 预 多 过 巧 浮 按钮 是 长 什么 样子 的 了 ， 它 默认 会 使 用 colorAccent 来 作为 
0 我 们 还 可 以 通过 给 按钮 指定 一 个 图 标 来 表明 这 个 按钮 的 作用 
是 什么 * 


下 面 开 始 来 具体 实现 。 首 先 仍然 需要 提前 准备 好 一 个 图 标 ， 这 里 我 放置 了 
一 张 ic_done.png 到 drawable-xxhdpi 目 未 下 。 人 然后 修改 activity_main.xml 中 的 
代码 ， 如 下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<FrameLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout_ width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat .Light" /> 


<android,.support.design.widget.FloatingActionButton 

android:id="@+id/fab" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="bottom|end" 
android:layout_margin="16dp" 
android:src="@drawable/ic_done" /> 

</FrameLayout> 


</android.support.v4.widget.DrawerLayout> 


| | 


可 以 看 到 ， 这 里 我 们 在 主屏 幕布 局 中 加 入 了 一 个 FloatingActionButton。 这 个 
控件 的 用 法 并 没有 什么 特别 的 地 方 ， layout_width 和 1layout_height 属性 都 
指定 成 wrap_content ，layout_gravity 属性 指定 将 这 个 控件 放置 于 屏幕 的 
右 下 角 ， 其 中 end 的 工作 原理 和 之 前 的 start 是 一 样 的 ， 即 如 果 系 统 语言 是 
从 左 往 右 的 ， 那 么 end 就 表示 在 右边 ， 如 有 果 系 统 语言 是 从 右 往 左 的 ， 那 么 
end 就 表示 在 左边 。 然 后 通过 1ayout_margin 属性 给 控件 的 四 周 留 点 边 距 ， 

紧 贴 着 屏幕 边缘 肯定 是 不 好 看 的 ， 最 后 通过 src 属性 给 FloatingActionButton 
设置 了 一 个 图 标 。 


没 错 ， 吏 是 这 么 稍 单 ， 现 在 我 们 束 可 以 来 运行 一 下 了 ， 效 采 如 岁 12.9 所 示 。 


三 Fruits 


图 12.9 ”其 浮 按钮 的 效果 


一 个 漂亮 的 世 浮 按钮 束 在 屏幕 的 右 下 方 出 现 了 。 


如 采 你 仔细 观察 的 话 ， 会 发 现 这 个 悬浮 按钮 鸭 下面 还 有 一 点 阴影 。 其 实 这 
很 好 理解 ， 因 为 FloatingActionButton 是 巧 浮 在 当前 界面 上 的 ， 既 然 是 巧 浮 ， 
那么 陇 理 所 应 当 会 有 投影 ，Design Support 库 连 这 种 细 和 都 帮 有 我 们 考虑 到 


说 到 悬浮 ， 其 实 我 们 还 可 以 指定 FloatingActionButton 的 悬浮 高 度 ， 如 下 所 
人 小 : 


<android.support.design.widget.FloatingActionButton 
android:id="@+id/fab" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="bottom|end" 
android:layout_margin="16dp" 


android:src="@drawable/ic_done" 
app:elevation="8dp" /> 


这 里 使 用 app:elevation 属性 来 给 FloatingActionButton 指 定 一 个 高 度 值 ， 高 
度 值 越 大 ， 投 影 范 围 也 越 大 ， 但 是 投影 效果 越 淡 ， 高 度 值 越 小 ， 投 影 范 围 
也 越 小 ， 但 是 投影 效果 越 浓 。 当 然 这 些 效 果 的 差异 其 实 都 不 怎么 明显 ， 我 
个 人 感觉 使 用 默认 的 FloatingActionButton 效 果 就 已 经 足够 了 。 


接 下 来 我 们 看 一 下 FloatingActionButton 是 如 何 处 理 点 击 事件 的 ， 毕 竟 ， 一 个 
按钮 首先 要 能 点 击 才 有 意义 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private DrawerLayout mDrawerLayout; 


QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setcontentView(R.1layout.activity_main); 


FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab); 
fab.setonCclickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Toast.makeText (MainActivity.this, "FAB clicked", Toast.LENGTH_ 
SHORT ) .show!( ); 


}); 


| | 


如 果 你 在 期 等 FloatingActionButton 会 有 什么 特殊 用 法 的 话 ， 那 可 能 就 要 让 你 
失望 了 ， 它 和 普通 的 Button 其 实 没什么 两 样 ， 都 是 调用 
setonclickListener() 方法 来 注册 一 个 监听 器 ， 当 点 击 按钮 时 ， 就 会 执行 监 
听 器 中 的 onclick() 方法 ， 这 里 我 们 在 onclick() 方法 中 弹出 了 一 个 Toast 。 


现在 重新 运行 一 下 程序 ， 并 点 击 FloatingActionButton， 效 果 如 图 12.10 所 
不 。 


A 


FAB clicked 


图 12.10 处理 FloatingActionButton 的 点 击 事件 


12.4.2 Snackbar 


现在 我 们 已 经 掌握 了 FloatingActionButton 的 基本 用 法 ， 不 过 在 上 一 小 和 处 理 
点 击 事件 的 时 候 ， 仍 然 是 使 用 Toast 来 作为 提示 工具 的 ， 本 小 市 中 我 们 就 来 
学 习 一 个 Design Support 库 提供 的 更 加 先进 的 提示 工具 Snackbar ° 


首先 要 明确 ，Snackbar 并 不 是 Toast 的 替代 品 ， 它 们 两 者 之 间 有 着 不 同 的 应 用 
场景 。Toast 的 作用 是 告诉 用 户 现在 发 生 了 什么 事情 ， 但 同时 用 户 只 能 被 动 
接收 这 个 事情 ， 因 为 没有 什么 办 法 能 让 用 户 进行 选择 。 而 Snackbar 则 在 这 方 
面 进行 了 扩展 ， 它 允许 在 提示 当中 加 入 一 个 可 交互 按钮 ， 当 用 户 点 击 按钮 
的 时 候 可 以 执行 一 些 额 外 的 逻辑 操作 。 打 个 比方 ， 如 果 我 们 在 执行 删除 操 
作 的 时 候 只 弹出 一 个 Toast 提 示 ， 那 么 用 户 要 是 误 删 了 某 个 重要 数据 的 话 肯 
定 会 十 分 抓 狂 吧 ， 但 是 如 果 我 们 增加 一 个 Undo 按 钮 ， 束 相当 于 给 用 户 提 供 
了 一 种 弥补 措施 ， 从 而 大 大 降低 了 事故 发 生 的 概率 ， 提 升 了 用 户 体验 。 


Snackbar 的 用 法 也 非常 简单 ， 它 和 Toast 是 基本 相似 的 ， 只 不 过 可 以 额外 增加 
一 个 按钮 的 点 击 事件 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private DrawerLayout mDrawerLayout; 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedIinstanceState); 
setcontentView(R.1layout.activity_main); 


FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab); 
fab.setonCclickListener(new View.OnClickListener() { 
QOverride 
public void onClick(View view) { 
Snackbar .make(view, "Data deleted", Snackbar .LENGTH_SHORT ) 
.SetAction("Undo", new View.OnClickListener() { 
Q@override 
public void onClick(View v) { 
Toast.makeText (MainActivity.this, "Data restored", 
Toast .LENGTH_SHORT) .show( ); 


可 以 看 到 ， 这 里 调用 了 Snackbar 的 make( ) 方法 来 创建 一 个 snackbar 对 象 ， 
make( ) 方法 的 第 一 个 参数 需要 传 入 一 个 View， 只 要 是 当前 界面 布局 的 任意 
一 个 View 都 可 以 ，Snackbar 会 使 用 这 个 View 来 目 动 查找 最 外 层 的 布局 ， 用 


于 展示 Snackbar。 第 二 个 参数 就 是 Snackbar 中 显示 的 内 容 ， 第 三 个 参数 是 
Snackbar 显 示 的 时 长 。 这 些 和 Toast 都 是 类 似 的 。 


接着 这 里 又 调用 了 一 个 setAction() 方法 来 设置 一 个 动作 ， 从 而 让 Snackbar 
不 仅仅 是 一 个 提示 ， 而 是 可 以 和 用 户 进行 交互 的 。 简 单 起 见 ， 我 们 在 动作 
按钮 的 点 击 事件 里 面 弹 出 一 个 Toast 提 示 。 最 后 调用 show( ) 方法 让 Snackbar 
显示 出 来 。 


现在 重新 运行 一 下 程序 ， 并 点 击 巧 浮 按钮 ， 效 末 如 图 12.11 所 示 。 
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图 12.11 ”Snackbar 的 效果 


可 以 看 到 ，Snackbar 从 屏幕 底部 出 现 了 ， 上 面 有 我 们 所 设置 的 提示 文字 ， 还 
有 一 个 Undo 按 钮 ， 按 钮 是 可 以 点 击 的 。 过 一 段 时 间 后 Snackbar 会 目 动 从 屏 
幕 底 部 消失 。 


不 管 是 出 现 还 是 消失 ，Snackbar 都 是 带 有 动画 效 采 的 ， 因 此 视觉 体验 也 会 比 
较 好 。 


不 过 你 有 没有 发 现 一 个 bug， 这 个 Snackbar 竟 然 将 我 们 的 巧 浮 按钮 给 遮挡 住 
了 了 人。 虽说 也 不 是 什么 重大 的 问题 ， 因 为 Snackbar 过 一 会 儿 就 会 目 动 消失 ， 但 
这 种 用 户 体验 总 归 是 不 友好 的 。 有 没有 什么 办 法 能 解决 一 下 呢 ? 当 然 有 ， 

只 需要 借助 CoordinatorLayout 就 可 以 轻松 解决 。 


12.4.3 CoordinatorLayout 


CoordinatorLayout 可 以 说 是 一 个 加 强 版 的 FrameLayout， 这 个 布局 也 是 由 
Design Support 库 提供 的 。 它 在 普通 情况 下 的 作用 和 FrameLayout 基 本 一 致 ， 
不 过 既然 是 Design Support 库 中 提供 的 布局 ， 那 么 就 必然 有 一 些 Material 
Design 的 魔力 了 。 


事实 上 ，CoordinatorLayout 可 以 监听 其 所 有 子 控件 的 各 种 事件 ， 然 后 目 动 帮 
助 我 们 做 出 最 为 合理 的 响应 。 举 个 人 简单 的 例子 ， 刚 才 弹 出 的 Snackbar 提 示 将 
巧 浮 按钮 遮挡 住 了 ， 而 如 果 我 们 能 让 CoordinatorLayout 监 听 到 Snackbar 的 弹 

出 事件 ， 那 么 它 会 目 动 将 内 部 的 FloatingActionButton 回 上 偏 移 ， 从 而 确保 不 
会 被 Snackbar 遮 挡 到 。 


至 于 CoordinatorLayout 的 使 用 也 非常 简单 ， 我 们 只 需要 将 原来 的 
FrameL ayout 符 换 一 下 就 可 以 了 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 
人 小: 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.design.widget.CoordinatorLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat .Light" /> 


<android,.support.design.widget.FloatingActionButton 
android:id="@+id/fab" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 


android:layout_gravity="bottom|end" 
android:layout_margin="16dp" 
android:src="@drawable/ic done" /> 
</android.support.design.widget.CoordinatorLayout> 


</android.support.v4.widget.DrawerLayout> 


由 于 CoordinatorLayout 本 号 束 是 一 个 加 强 版 的 FrameLayout， 因 此 这 种 替换 


会 有 任何 的 副作用 。 现 在 重新 运行 一 下 程序 ， 并 点 击 巧 浮 按钮 ， 效 果 如 
图 12.12 所 示 。 
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图 12.12 ”CoordinatorLayout 自 动 将 巧 浮 按 钮 上 移 


可 以 看 到 ， 蕊 浮 按钮 自动 同上 偏 移 了 Snackbar 的 同等 高 度 ， 从 而 确保 不 会 被 
让 挡住 ， 当 Snackbar 消 失 的 时 候 ， 最 浮 按钮 会 自动 同 下 偏 移 回 到 原来 位 置 。 


另外 巧 浮 按钮 的 回 上 和 癌 下 偏 移 也 是 伴随 着 动画 效果 的 ， 且 和 Snackbar 完 全 
同步 ， 整 体 效果 看 上 去 特别 介 心 悦目 。 


不 过 我 们 回 过 头 来 再 思考 一 下 ， 了 刚才 说 的 是 CoordinatorLayout 可 以 监听 其 所 
有 子 控件 的 各 种 事件 ， 但 是 Snackbar 好 像 并 不 是 CoordinatorLayout 的 子 控件 
吧 ， 为 什么 它 却 可 以 被 监听 到 呢 ? 


其 实 道理 很 简单 ， 还 记得 我 们 在 Snackbar 的 make() 方法 中 传 入 的 第 一 个 参数 
吗 ? 这 个 参数 吏 是 用 来 指定 Snackbar 是 基于 哪个 View 来 触发 的 ， 刚 才 我 们 传 
入 的 是 FloatingActionButton 本 号 ， 而 FloatingActionButton 是 
CoordinatorLayout 中 的 子 控件 ， 因 此 这 个 事件 束 理 所 应 当 能 被 监听 到 了 。 你 
可 以 上 自己 再 做 个 试验 ， 如 果 给 Snackbar 的 make() 方法 传 入 一 个 
DrawerLayout， 那 么 Snackbar 束 会 再 次 遮挡 住 悬 浮 按 钮 ， 因 为 DrawerLayonut 
不 是 CoordinatorLayout 的 子 控件 ，CoordinatorLayout 也 就 无 法 监听 到 
Snackbar 的 弹出 和 隐藏 事件 了 。 


本 市 的 内 容 束 到 这 里 ， 接 下 来 我 们 继续 丰富 MaterialTest 项 目 ， 加 入 卡 厂 式 
布局 效果 。 


12.5 ”卡片 式 布局 


虽然 现在 MaterialTest 中 已 经 应 用 了 非常 多 的 Material Design 效 果 ， 不 过 你 会 
发 现 ， 界 面 上 最 主要 的 一 块 区 域 还 处 于 空 日 状态 。 这 块 区 域 通常 都 是 用 来 
J 的 主体 内 容 的 ， 我 准备 使 用 一 些 精美 的 水 果 图 片 来 填充 这 部 分 区 
域 。 


那么 为 了 要 让 水 末 图 片 也 能 Material 化 ， 本 市 中 我 们 将 会 学 习 如 何 实 现 卡 片 
式 布局 的 效果 。 卡 片 式 布局 也 是 Materials Design 中 提出 的 一 个 新 的 概念 ， 它 
可 以 让 页 面 中 的 元 素 看 起 来 瑟 像 在 卡片 中 一 样 ， 并 且 还 能 拥有 圆 角 和 投 

影 ， 下 面 我 们 束 开 始 具体 学 习 一 下 。 


12.5.1 CardView 


CardView 是 用 于 实现 卡片 式 布局 效果 的 重要 控件 ， 由 appcompat-v7 库 提供 。 
实际 上 ，CardView 也 是 一 个 FrameLayout， 只 是 额外 提供 了 圆 角 和 阴影 等 效 
果 ， 看 上 去 会 有 立体 的 感觉 。 


我 们 先 来 看 一 下 CardView 的 基本 用 法 吧 ， 其 实 非常 位 单 ， 如 下 所 示 : 


<android.support.v7.widget.CardView 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
app:cardCornerRadius="4dp" 
app:elevation="5dp"> 
<TextView 
android:id="@+id/info_text" 


android:layout_width="match_parent" 
android:layout_height="wrap_content"/> 
</android.support.v7.widget.CardView> 


这 里 定义 了 一 个 CardView 布 局 ， 我 们 可 以 通过 app:cardcornerRadius 属性 
指定 卡片 圆 角 的 弧度 ， 数 值 越 大 ， 圆 角 的 弧度 也 越 大 。 另 外 还 可 以 通过 
app:elevation 属性 指定 卡片 的 高 度 ， 高 度 值 越 大 ， 投影 范围 也 越 大 ， 但 是 
投影 效果 越 淡 ， 高 度 值 越 小 ， 投 影 范 围 也 越 小 ， 但 是 投影 效果 越 浓 ， 这 一 
点 和 FloatingActionButton 是 一 致 的 。 


然后 我 们 在 CardView 布 局 中 放置 了 一 个 TextView， 那 么 这 个 TextView 束 会 显 
示 在 一 张 卡 片 当 中 了 ，CardView 的 用 法 就 是 这 么 简单 。 


但 是 我 们 显然 不 可 能 在 如 此 视 阔 的 一 块 空 日 区 域内 只 放置 一 张 卡 片 ， 为 了 
能 够 充分 利用 屏幕 的 空间 ， 这 里 我 准备 综合 运用 一 下 第 3 章 中 学 到 的 知识 ， 
使 用 RecyclerView 来 填充 MaterialTest 项 目的 主 界面 部 分 。 还 记得 之 前 实现 过 
这 次 我 们 将 升级 一 下 ， 实 现 一 个 高 配 厂 的 水 果 列 表 歼 


既然 是 要 实现 水 果 列 表 ， 那 么 首先 肯定 需要 准备 许多 张 水 采 图 片 ， 这 里 我 
从 网 上 挑选 了 一 些 精 美的 水 采 图 片 ， 将 它们 复制 到 了 项 目 当中 。 


然后 由 于 我 们 还 需要 用 到 RecyclerView、CardView 这 几 个 控件 ， 因 此 必须 在 
app/build.gradle 文 件 中 声明 这 些 库 的 依赖 才 行 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android.support:appcompat-v7:24.2.1" 
testCompile 'junit:junit:4.12"' 
compile 'com.android.support:design:24.2.1" 
compile 'de.hdodenhof:circleimageview:2.1.0' 


compile 'com.android.support:recyclerview-v7:24.2.1' 
compile 'com.android.support:cardview-v7:24.2.1' 
compile 'com.github.bumptech.glide:glide:3.7.0' 


主意 上 述 声 明 的 最 后 一 行 ， 这 里 添加 了 一 个 Glide 库 的 依赖 。Glide 是 一 个 超 
级 强大 的 图 片 加载 库 ， 它 不 仅 可 以 用 于 加 载 本 地 图 片 ， 还 可 以 加 载 网 络 图 
片 、GIF 图 片 、 甚 至 是 本 地 视频 。 最 重要 的 是 ，Glide 的 用 法 非常 价 单 ， 只 需 
一 行 代码 束 能 轻松 实现 复杂 的 图 片 加 载 功 能 ， 因 此 这 里 我 们 准备 用 它 来 加 
载 水 果 图 片 。Glide 的 项 目 主页 地 址 是 : https://github.com/bumptech/glide 。 


接 下 来 开始 具体 的 代码 实现 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


一 < 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.design.widget.CoordinatorLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat .Light" /> 


<android,.support.v7.widget.RecyclerView 
android:id="@+id/recycler_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" /> 


<android,.support.design.widget.FloatingActionButton 

android:id="@+id/fab" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="bottom|end" 
android:layout_margin="16dp" 
android:src="@drawable/ic_done" /> 

</android. support.design.widget.CoordinatorLayout> 


</android.support.v4.widget.DrawerLayout> 


这 里 我 们 在 CoordinatorLayout 中 添加 了 一 个 RecyclerView， 给 它 指定 一 个 
id， 然 后 将 宽度 和 高 度 都 设置 为 natch_parent， 这 样 RecyclerView 也 就 占 满 了 
整个 布局 的 空间 。 


接着 定义 一 个 实体 类 Fruit ， 代 码 如 下 所 示 : 


public class Fruit { 
private String name; 
private int ImageId ， 
public Fruit(String name, int imageId) { 


this.name = name; 
this.imagelId = ImageId ， 


} 


public String getName() { 


return name,; 


} 


public int getImageId() { 
return imagelId; 
} 


Fruit 类 中 只 有 两 个 字段 ，name 表示 水 果 的 名 字 ，imageId 表示 水 果 对 应 图 
片 的 资源 id 。 


然后 需要 为 RecyclerView 的 子 项 指定 一 个 我 们 自 定义 的 布局 ， 在 layout 目 录 
下 新 建 fruit_item.xml， 代 码 如 下 所 示 : 


<android.support.v7.widget.CardView 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_margin="5dp" 
app:cardCornerRadius="4dp"> 


<LinearLayout 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 


<ImageView 
android:id="@+id/fruit_image" 
android:layout_width="match_parent" 
android:layout_height="100dp" 
android:scaleType="centerCrop" /> 


<TextView 

android:id="@+id/fruit_name" 

android:layout_width="wrap_content" 

android:layout_height="wrap_content" 

android:layout_gravity="center_horizontal" 

android:layout_margin="5dp" 

android:textSize="16sp" /> 
</LinearLayout> 


</android.support.v7.widget.CcCardView> 


| | 


这 里 使 用 了 CardView 来 作为 子 项 的 最 外 层 布 局 ， 从 而 使 得 RecyclerView 中 的 
每 个 元 素 都 是 在 卡片 当中 的 。CardView 由 于 是 一 个 FrameLayout， 因 此 它 没 
有 什么 方便 的 定位 方式 ， 这 里 我 们 只 好 在 CardView 中 再 岁 套 一 个 
LinearLayout， 然 后 在 LinearLayout 中 放置 具体 的 内 容 。 


内 容 倒 也 没有 什么 特殊 的 地 方 ， 残 是 定义 了 一 个 ImageView 用 于 显示 水 果 的 
图 片 ， 又 定义 了 一 个 TextView 用 于 显示 水 果 的 名 称 ， 并 让 TextView 在 2 
同上 居中 显示 。 注 意 在 ImageView 中 我 们 使 用 了 一 个 scaleType 属性 ， 这 

属性 可 以 指定 图 片 的 缩放 模式 。 由 于 各 张 水 果 图 片 的 长 贤 比 例 可 外 部 不 一 
致 ， 为 了 让 所 有 的 图 片 都 能 填充 满 整个 ImageView， 这 里 使 用 了 centerCrop 
ee 保持 原 有 比例 填充 满 ImageView， 并 将 超出 屏幕 的 部 分 


接 下 来 需要 为 RecyclerView 准 备 一 个 适配器 ， 新 建 FruitAdapter 类 ， 让 这 个 
适配器 继承 目 RecyclerView.Adapter， 并 将 泛 型 指定 为 
FruitAdapter.ViewHolder， 代 码 如 下 所 示 : 


public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> { 


private Context mContext; 
private List<Fruit> mFruitList; 


static class ViewHolder extends RecyclerView.ViewHolder { 
CardView cardView; 
ImageView fruitImage; 
TextView fruitName; 


public ViewHolder(View view) { 
super (view); 
cardView = (CardView) view; 
fruitImage = (ImageView) view.findViewById(R.id.fruit image); 
fruitName = (TextView) view.findViewById(R.id.fruit_name); 
} 
+ 


public FruitAdapter(List<Fruit> fruitList) { 
mFruitList = fruitList; 


} 


QOverride 
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { 
If (mContext == null) { 
mContext = parent.getContext(); 


View view = LayoutIinflater.from(mContext).inflate(R.]layout.fruit_item, 
parent, false); 
return new ViewHolder (view); 


QOverride 

public void onBindViewHolder(ViewHolder holder, int position) { 
Fruit fruit = mFruitList.get(position); 
holder .fruitName.setText(fruit.getName()); 
Glide.with(mContext).1load(fruit.getIimageId()).into(holder.fruitImage); 


} 


QOverride 
public int getItemCount() { 
return mFruitList.sizel(); 


上 述 代 码 相信 你 一 定 很 熟悉 ， 和 我 们 在 第 3 章 中 编写 的 FruitAdapter 儿 乎 一 模 
一 样 。 唯 一 需要 注意 的 是 ， 在 onBindviewHolder() 方法 中 我 们 使 用 了 Glide 
来 加 载 水 有 果 图 片 。 


那么 这 里 就 顺便 来 看 一 下 Glide 的 用 法 吧 ， 其 实 并 没有 太 多 好 讲 的 ， 因 为 
Glide 的 用 法 实在 是 太 简 单 了 。 首 先 调用 6Glide.with() 方法 并 传 入 一 个 
Context 、Activity 或 Fragment 参数 ， 然后 调用 1oad() 方法 去 加 载 图 片 ， 

可 以 是 一 个 URL 地 址 ， 也 可 以 是 一 个 本 地 路 径 ， 或 者 是 一 个 资源 id， 最 后 调 
用 into() 方法 将 图 片 设置 到 具体 某 一 个 ImageView 中 就 可 以 了 。 


那么 我 们 为 什么 要 使 用 Glide 而 不 是 传统 的 设置 图 片 方式 呢 ? 因为 这 次 我 从 
网 上 找 的 这 些 水 来 图 片 像 素 部 非常 高 ， 如 果 不 进行 压缩 束 直 接 展 示 的 话 ， 
很 容易 就 会 引起 内 存 淤 出。 而 使 用 Glide 就 完全 不 需要 担心 这 回 事 ， 因 为 
Glide 在 内 部 做 了 许多 非常 复杂 的 逻辑 操作 ， 其 中 束 包 括 了 图 片 压 缩 ， 我 们 
只 需要 安心 按照 Glide 的 标准 用 法 去 加 载 图 片 就 可 以 了 。 


这 样 我 们 就 将 RecyclerView 的 适配器 也 准备 好 了 ， 最 后 修改 MainActivity 中 
的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private DrawerLayout mDrawerLayout; 


private Fruit[] fruits = {new Fruit("Apple", R.drawable.apple), new Fruit("Banana", 
R.drawable.banana), 

new Fruit("Orange", R.drawable.orange), new Fruit("watermelon", R. 
drawable.watermelon), 

new Fruit("Pear", R.drawable.pear), new Fruit("Grape", R.drawable. 
grape), 

new Fruit("Pineapple", R.drawable.pineapple), new Fruit("Strawberry", 
R.drawable. strawberry), 

new Fruit("Cherry", R.drawable.cherry), new Fruit("Mango", R.drawable. 
mango)}; 


private List<Fruit> fruitList = new ArrayList<>()， 


private FruitAdapter adapter ; 


@override 

protected void onCreate(Bundle SavedInstanceState) { 
Super .onCreate(SavedInstanceState ) 
setcontentView(R.1layout.activity_main); 


initFruits(); 

RecyclerView recyclerView = (RecyclerView) findViewById(R.id. 和 View) 
GridLayoutManager layoutManager = new GridLayoutManager(this, 2 
recyclerView.setLayoutManager (layoutManager); 

adapter = new FruitAdapter(fruitList); 

recyclerView.setAdapter (adapter ) ， 


} 


private void initFruits() { 
fruitList.clear(); 
for (int i = 0; i < 50; i++) { 
Random random = new Random(); 
int index = random.nextInt(fruits.1length); 
fruitList.add(fruits[index]); 


在 MainActivity 中 我 们 首先 定义 了 一 个 数组 ， 数 组 里 面 存放 了 很 多 个 Fruit 
的 实例 ， 每 个 实例 都 代表 着 一 种 水 果 。 然 后 在 initFruits() 方法 中 ， 先 是 
清空 了 一 下 fruitList 中 的 数据 ， 接 着 使 用 一 个 随机 函数 ， 从 刚才 定义 的 

Fruit 数组 中 随机 挑选 一 个 水 果 放 入 到 fruitList 当中 ， 这 样 每 次 打开 程序 
看 到 的 水 果 数 据 都 会 是 不 同 的 。 另 外 ， 为 了 让 界面 上 的 数据 多 一 些 ， 这 里 
使 用 了 一 个 循环 ， 随 机 挑选 50 个 水 果 。 


后 的 用 法 就 是 RecyclerView 的 标准 用 法 了 ， 不 过 这 里 使 用 了 
GridLayoutManager 这 种 布局 方式 。 在 第 3 章 中 我 们 已 经 学 过 了 
LinearLayoutManager 和 StaggeredGridLayoutManager， 现在 终 终于 将 所 有 的 布 
局 方式 都 补 齐 了 。GridLayoutManager 的 用 法 也 没有 什么 特 另 上 之 处 ， 它 的 构 
造 和 页 数 接收 两 个 参数 ， 第 一 个 是 context ， 第 二 个 是 列 数 ， 这 里 我 们 希望 每 

一 行 中 会 有 两 列 数据 。 


现在 重新 运行 一 下 程序 ， 效 果 如 图 12.13 所 示 。 


图 12.13 卡片 式 布局 效果 


可 以 看 到 ， 精 美的 水 果 图 片 成 功 展示 出 来 了 。 每 个 水 果 都 是 在 一 张 单 独 的 
卡片 当中 的 ， 并 且 还 拥有 圆 角 和 投影 ， 是 不 是 非常 美观 ? 另外 ， 由 于 我 们 
是 使 用 随机 的 方式 来 获取 水 有 果 数据 的 ， 因 此 界面 上 会 有 一 些 重复 的 水 采 出 
现 ， 这 属于 正常 现象 。 

当 你 陶醉 于 当前 精美 的 界面 的 时 候 ， 你 是 不 是 忽略 了 一 个 细 市 ? 哎呀 ,我 
们 的 Toolbar 怎 么 不 见 了 ! 仔细 观察 一 下 原来 是 被 RecyclerView 给 挡住 了 。 这 
个 问题 又 该 怎么 解决 呢 ? 这 束 需 要 借助 到 另外 一 个 工具 了 
AppBarLayout ° 


12.5.2 AppBarLayout 


首先 我 们 来 分 析 一 下 为 什么 RecyclerView 会 把 Toolbar 给 遮挡 住 吧 。 其 实 并 不 
难 理解 ， 由 于 RecyclerView 和 Toolbar 都 是 放置 在 CoordinatorLayout 中 的 ， 而 
前 面 已 经 说 过 ，CoordinatorLayout 就 是 一 个 加 强 版 的 FrameLayout， 那 么 
FrameLayout 中 的 所 有 控件 在 不 进行 明确 定位 的 情况 下 ， 默 认 都 会 摆 放 在 布 
局 的 左上 角 ， 从 而 也 束 产 生 了 遮挡 的 现象 。 其 实 这 已 经 不 是 你 第 一 次 遇 到 
这 种 情况 了 ， 我 们 在 3.3.3 小 和 学 习 FrameLayout 的 时 候 就 早已 见识 过 了 控件 
与 控件 之 间 遮 挡 的 效果 。 


既然 已 经 找到 了 问题 的 原因 ， 那 么 该 如 何 解决 呢 ? 传统 情况 下 ， 使 用 侦 移 
是 唯一 的 解决 办 法 ， 即 让 RecyclerView 回 下 偏 移 一 个 Toolbar 的 高 度 ， 从 而 保 
证 不 会 让 挡 到 Toolbar。 不 过 我 们 使 用 的 并 不 是 普通 的 FrameLayout， 而 是 
CoordinatorLayout， 因 此 自然 会 有 一 些 更 加 巧妙 的 解决 办 法 。 


这 里 我 准备 使 用 Design Support 库 中 提供 的 男 外 一 个 工具 一 一 
AppBarLayout。AppBarLayout 实 际 上 是 一 个 垂直 方向 的 LinearLayout， 它 在 
内 部 做 了 很 多 滚动 事件 的 封闭， 并 应 用 了 一 些 Material Design 的 设计 理念 。 


那么 我 们 怎样 使 用 AppBarLayout 才 能 解决 前 面 的 覆盖 问题 呢 ? 其 实 只 需要 
两 步 束 可 以 了 ， 第 一 步 将 Toolbar 藤 套 到 AppBarLayout 中 ， 第 二 步 给 
RecyclerView 指 定 一 个 布局 行为 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 
人 小 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.design.widget.CoordinatorLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.design.widget.AppBarLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 


<android.support.v7.widget.Toolbar 

android:id="@+id/toolbar" 

android:layout_ width="match_parent" 

android:layout_height="?attr/actionBarSize" 

android:background="?attr/colorPrimary" 

android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 

app:popupTheme="@style/ThemeOverlay.AppCompat .Light" /> 
</android.support.design.widget.AppBarLayout> 


<android,.support.v7.widget.RecyclerView 
android:id="@+id/recycler_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
app:layout_behavior="@string/appbar_scrolling_view_ behavior" /> 


</android.support.design.widget.CoordinatorLayout> 


</android.support.v4.widget.DrawerLayout> 


可 以 看 到 ， 布 局 文件 并 没有 什么 太 大 的 变化 。 我 们 首先 定义 了 一 个 
AppBarLayout， 并 将 Toolbar 放 置 在 了 AppBarLayout 里 面 ， 然 后 在 
RecyclerView 中 使 用 app:1ayout_behavior 属性 指定 了 一 个 布局 行为 。 其 中 
appbar_scrolling_view_behavior 这 个 字符 串 也 是 由 Design Support 库 提供 


的 。 


现在 重新 运行 一 下 程序 ， 你 就 会 发 现 一 切 都 正常 了 ， 如 图 12.14 所 示 。 


Cherry 


Pear Orange 


Pineapple 


图 12.14 解决 Recyclerview 人 遮挡 Toolbar 的 问题 


虽说 使 用 AppBarLayonut 已 经 成 功 解决 了 RecyclerView 遮 挡 Toolbar 的 问题 ， 但 
是 刚才 有 提 到 过 ， 说 AppBarLayout 中 应 用 了 一 些 Material Design 的 设计 理 
念 ， 好 像 从 上 面 的 例子 完全 体现 不 出 来 呀 。 事 实 上 ， 当 RecyclerView 演 动 的 
时 候 束 已 经 将 滚动 事件 都 通知 给 AppBarLayout 了 ， 只 是 我 们 还 没 进行 处 理 
而 已 。 那 么 下 面 束 让 我 们 来 进一步 优化 ， 看 看 AppBarLayout 到 底 能 实现 什 
么 样 的 Material Design 鸡 果 。 


当 AppBarLayout 接 收 到 深 动 事件 的 时 候 ， 它 内 部 的 子 控件 其 实 是 可 以 指定 
如 何 去 影 响 这 些 事件 的 ， 通 过 app: layout_scroLlLlFlags 属性 就 能 实现 。 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.design.widget.CoordinatorLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.design.widget.AppBarLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 


<android.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match_parent" 


android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat .Light" 
app:layout_scrollFlags="scroll|enterAlways|snap" /> 
</android.support.design.widget.AppBarLayout> 


</android.support.design.widget.CoordinatorLayout> 


</android.support.v4.widget.DrawerLayout> 


这 里 在 Toolbar 中 添加 了 一 个 app:1ayout_scrollFlags 属性 ， 并 将 这 个 属性 
的 值 指 定 成 了 scroll|enterAlways|snap 。 其 中 ，scrol1 表示 当 
RecyclerView 回 上 滚动 的 时 候 ，Toolbar 会 跟着 一 起 癌 上 滚动 并 实现 隐藏; 
enterAlways 表示 当 RecyclerView 辐 下 滚动 的 时 候 ，Toolbar 会 跟着 一 起 加 下 


滚动 并 重新 显示 。snap 表示 当 Toolbar 还 没有 完全 隐藏 或 显示 的 时 候 ， 会 根 
据 当 前 滚动 的 距离 ， 目 动 选择 是 隐藏 还 是 显示 。 


我 们 要 改动 的 束 只 有 这 一 行 代 码 而 已 ， 现 在 重新 运行 一 下 程序 ， 并 癌 上 深 
动 RecyclerView， 歼 果 如 图 12.15 所 示 。 


Watermelon 


cd 


Strawberry 


图 12.15 ”向 上 滚动 RecyclerView 隐 藏 IToolbar 


可 以 看 到 ， 随 着 我 们 向 上 滚动 RecyclerView，Toolbar 况 然 消 失 了 ， 而 向 下 深 
动 RecyclerView，Toolbar 又 会 重新 出 现 。 这 其 实 也 是 Material Design 中 的 一 
项 重要 设计 思想 ， 因 为 当 用 户 在 同上 滚动 RecyclerView 的 时 候 ， 其 注意 力 肯 
定 是 在 RecyclerView 的 内 容 上 面 的 ， 这 个 时 候 如 果 Toolbar 还 占据 着 屏 舌 空 

间 ， 束 会 在 一 定 程度 上 影响 用 户 的 阅读 体验 ， 而 将 Toolbar 隐 藏 则 可 以 让 阅 
读 体验 达到 最 佳 状态 。 当 用 户 需 要 操作 Toolbar 上 的 功能 时 ， 只 需要 轻微 癌 
下 滚动 ，Toolbar 就 会 重新 出 现 。 这 种 设计 方式 ， 既 保证 了 用 户 的 最 佳 阅 读 


效果 ， 又 不 影 啊 任何 功能 上 的 操作 ，Material Design 考 虑 得 束 是 这 么 细致 入 
微 。 


当然 了 ， 像 这 种 功能 ， 如 果 是 使 用 ActionBar 的 话 ， 那 就 完全 不 可 能 实现 
了 ，Toolbar 的 出 现 为 我 们 提供 了 更 多 的 可 能 。 


12.6 ”下拉 刷 新 


下 拉 刷 新 这 种 功能 早 就 不 是 什么 新 鲜 的 东西 了 ， 儿 乎 所 有 的 应 用 里 都 会 有 
这 个 功能 。 不 过 市 面 上 现 有 的 下 拉 刷 新 功能 在 风格 上 都 各 不 相同 ， 并 且 和 
Material Design 下 有 些 格 格 不 入 的 感觉 。 因 此 ， 人 谷歌 为 了 让 Android 的 下 拉 刷 
新 风格 能 有 一 个 统一 的 标准 ， 于 是 在 Material Design 中 制定 了 一 个 官方 的 设 
计 规 范 。 当 然 ， 我 们 并 不 需要 去 深入 了 解 这 个 规范 到 底 是 什么 样 的 ， 因 为 
谷歌 早 就 提供 好 了 现成 的 控件 ， 我 们 只 需要 在 项 目 中 直接 使 用 就 可 以 了 。 


SwipeRefreshLayout 就 是 用 于 实现 下 拉 刷 新 功能 的 核心 类 ， 它 是 由 support-v4 
库 提 供 的 。 我 们 把 想 要 实现 下 拉 刷 新 功能 的 控件 放置 到 SwipeRefreshLayonut 
中 ， 就 可 以 迅速 让 这 个 控件 支持 下 拉 刷 新 。 那 么 在 MaterialTest 项 目 中 ， 应 
该 文 持 下 拉 刷 新 功能 的 控件 自然 就 是 RecyclerView 了 。 


由 于 SwipeRefreshLayout 的 用 法 也 比较 简单 ， 下 面 我 们 残 直 接 开始 使 用 了 。 
修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.design.widget.CoordinatorLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.v4.widget.SwipeRefreshLayout 
android:id="@+id/swipe_refresh" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
app:layout_behavior="@string/appbar_scrolling_ view behavior"> 


<android.support.v7.widget.RecyclerView 
android:id="@+id/recycler_view" 
android:layout width="match_parent" 
android:layout_height="match_parent" /> 
</android.support.v4.widget.SwipeRefreshLayout> 


</android.support.design.widget.CoordinatorLayout> 


</android.support.v4.widget.DrawerLayout> 


可 以 看 到 ， 这 里 我 们 在 RecyclerView 的 外 面 又 舱 套 了 一 层 
SwipeRefreshLayout, 这 样 RecyclerView 束 目 动 拥有 下 拉 刷 新 功能 了 。 男 外 


需要 注意 ， 由 于 RecyclerView 现 在 变 变 成 了 SwipeRefreshLayout 的 子 控件 ， 因 


此 之 前 使 用 app:1layout_behavior 声明 的 布局 行为 现在 也 要 移 到 
SwipeRefreshLayout 中 才 行 。 


不 过 这 还 没有 结束 ， 虽然 RecyclerView 已 经 文 持 下 拉 刷 新 功能 了 ， 但 是 我 们 
还 要 在 代码 中 处 理 具体 的 刷 狐 逻辑 才 行 。 修 改 MainActivity 中 的 代码 ， 如 下 
所 示 : 


public class MainActivity extends AppCompatActivity { 


private SwipeRefreshLayout swipeRefresh,; 


QOverride 

protected void onCreate(Bundle savedIinstanceState) { 
super.onCreate(savedIinstanceState); 
setcontentView(R.1layout.activity_main); 


swipeRefresh = (SwipeRefreshLayout) findViewById(R.id.swipe_refresh); 
swipeRefresh.setCcolorSchemeResources(R.color.colorPrimary); 
swipeRefresh.setOonRefreshListener(new SwipeRefreshLayout. 
OnRefreshListener() { 
Q@Override 
public void onRefresh() { 
refreshFruits(); 


}); 
} 


private void refreshFruits() { 
new Thread(new Runnable() { 
@Override 
public void run() { 
try { 
Thread.sleep(2000); 
} catch (InterruptedException e) { 
e.printSstackTrace( ); 


runonUiThread(new Runnable() { 
Q@Override 
public void run() { 
initFruits(); 
adapter .notifyDataSetCchanged( ); 
swipeRefresh.setRefreshing(false); 


}); 


} 
}).start(); 


这 上 段 代 码 应 该 还 是 比较 好 理解 的 ， 首 先 通 过 findviewById() 方法 拿 到 
SwipeRefreshLayout 的 实例 ， 然 后 调用 setcolorschemeResources() 方法 来 设 
置 下 拉 刷 新 进度 条 的 颜色 ， 这 里 我 们 就 使 用 主题 中 的 colorPrimary 作 为 进度 


条 的 颜色 了 。 接着 调用 setonRefreshListener()) 方法 来 设置 一 个 下 拉 刷 新 的 
监听 需 ， 当 触发 了 下 拉 刷 新 操作 的 时 候 驶 会 回调 这 个 监听 壤 的 onRefresh( ) 
方法 ， 然 后 我 们 在 这 里 去 处 理 具体 的 刷新 逻辑 就 可 以 了 。 


通常 情况 下 ，onRefresh() 方法 中 应 该 是 去 网 络 上 请 求 最 新 的 数据 ， 人 然后 再 
将 这 些 数据 展示 出 来 。 这 里 簿 单 起 见 ， 我 们 残 不 和 了 网络 进行 交互 了 ， 而 是 
调用 一 个 refreshFruits() 方法 进行 本 地 刷新 操作 。refreshFruits() 方法 
中 先是 开启 了 一 个 线程 ， 然 后 将 线程 沉睡 两 秒 钟 。 之 所 以 这 么 做 ， 是 因为 
本 地 刷新 操作 速度 非常 快 ， 如 果 不 将 线程 沉睡 的 话 ， 刷 新 立刻 就 结束 了 ， 
从 而 看 不 到 刷新 的 过 程 。 沉 睡 结束 之 后 ， 这 里 使 用 了 runonuiThread() 图 法 
将 线程 切换 回 主线 程 ， 然 后 调用 initFruits() 方法 重新 生成 数据 ， 接 着 再 
调用 FruitAdapter 的 notifyDatasetchanged() 方法 通知 数据 发 生 了 变化 ， 最 
后 调用 SwipeRefreshLayout 的 setRefreshing() 方法 并 传 入 false ， 用 于 表示 
刷新 事件 结束 ， 并 隐藏 刷新 进度 条 。 


现在 可 以 重新 运行 一 下 程序 了 ， 在 屏幕 的 主 界面 向 下 拖 动 ， 会 有 一 个 下 拉 
刷新 的 进度 条 出 现 ， 松 手 后 束 会 自动 进 行 刷 新 了 ， 效 果 如 图 12.16 所 示 。 


图 12.16 实现 下 拉 刷 新 效果 


下 拉 刷 新 的 进度 条 只 会 停留 两 秒 钟 ， 之 后 就 会 自动 消失 ， 界 面 上 的 水 有 果 数 
据 也 会 随 之 更 新 。 


这 样 我 们 就 把 下 拉 刷 新 的 功能 也 成 功 实现 了 ， 并 且 这 就 是 Material Design 中 
规定 的 最 标准 的 下 拉 刷 新 效果 ， 还 有 什么 会 比 这 个 更 好 看 呢 ? 目 前 我 们 的 
项 目 中 已 经 应 用 了 众多 Material Design 的 效果 ，Design Support 库 中 的 常用 控 
件 也 学 了 大 半 了 。 不 过 本 章 的 学 习 之 旅 还 没有 结束 ， 在 最 后 的 尾声 部 分 ， 
我 们 再 来 实现 一 个 非常 震撼 的 Material Design 效 果 一 一 可 折 营 式 标题 柱 。 


12.7 可 折 秋 式 标题 栏 


虽说 我 们 现在 的 标题 栏 是 使 用 Toolbar 来 编写 的 ， 不 过 它 看 上 去 和 传统 的 
ActionBar 其 实 没什么 两 样 ， 只 不 过 可 以 啊 应 RecyclerView 的 滚动 事件 来 进行 
隐藏 和 显示 。 而 Material Design 中 并 没有 限定 标题 栏 必 须 是 长 这 个 样子 的 ， 
事实 上 ， 我 们 可 以 根据 自己 的 喜好 随意 定制 标题 栏 的 样式 。 那 么 本 节 中 我 
们 就 来 实现 一 个 可 折 县 式 标 题 栏 的 效果 ， 需 要 借助 CollapsingToolbarLayonut 
这 个 工具 。 


12.7.1 CollapsingToolbarLayout 


顾名思义 ，CollapsingToolbarLayout 是 一 个 作用 于 Toolbar 基 础 之 上 的 布局 ， 
它 也 是 由 Design Support 库 提供 的 。CollapsingToolbarLayout 可 以 让 Toolbar 的 
效果 变 得 更 加 丰富， 不 仅仅 是 展示 一 个 标题 栏 ， 而 是 能 够 实现 非常 华丽 的 
效果 。 


不 过 ，CollapsingToolbarLayout 是 不 能 独立 存在 的 ， 它 在 设计 的 时 候 就 被 限 
定 只 能 作为 AppBarLayout 的 直接 子 布局 来 使 用 。 而 AppBarLayout 又 必须 是 
CoordinatorLayout 的 子 布局 ， 因 此 本 节 中 我 们 要 实现 的 功能 其 实 需 要 综合 运 
用 前 面 所 学 的 各 种 知识 。 那 么 话 不 多 说 ， 这 就 开始 吧 。 


首 爷 我们 需要 一 个 额外 的 活动 来 作为 水 果 的 详情 展示 界面 ， 右 击 
com.example.materialtest 包 一 New 一 Activity -Empty Activity， 创 建 一 个 
FruitActivity， 并 将 布局 名 指定 成 activity_fruit.xml， 然 后 我 们 开始 编写 水 果 
详情 展示 界面 的 布局 。 


由 于 整个 布局 文件 比较 复杂 ， 这 里 我 准备 来 用 分 段 编 写 的 方式 。 
activity_fruit.xml 中 的 内 容 主要 分 为 两 部 分 ， 一 个 是 水 末 标 题 栏 ， 一 个 是 水 
采 内 容 详情 ， 我 们 来 一 步 步 实现 。 


首先 实现 标题 栏 部 分 ， 这 里 使 用 CoordinatorLayout 来 作为 最 外 层 布 局 ， 如 下 
所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


</android.support.design.widget.CoordinatorLayout> 


一 开始 的 代码 还 是 比较 简单 的 ， 相 信 没 有 什么 需要 解释 的 地 方 。 注 意 始终 
记得 要 定义 一 个 xmlns:app 的 命名 空 | 在 Material Design 的 开发 中 会 经 常 
用 到 它 


接着 我 们 在 CoordinatorLayout 中 般 套 一 个 AppBarLayout， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.design.widget.AppBarLayout 
android:id="@+id/appBar" 
android:layout_width="match_parent" 
android:layout_height="250dp"> 

</android.support.design.widget.AppBarLayout> 


</android.support.design.widget.CoordinatorLayout> 


目前 为 止 也 没有 什么 难 理解 的 地 方 ， 我 们 给 AppBarLayout 定 义 了 一 个 id， 将 
它 的 宽度 指定 为 match_parent ， 高 度 指 定 为 250dp。 当 然 这 里 的 高 度 值 你 可 
以 随意 指定 ， 不 过 我 尝试 之 后 发 现 250dp 的 视觉 效果 比较 好 。 


接 下 来 我 们 在 AppBarLayout 中 再 舱 套 一 个 CollapsingToolbarLayout， 如 下 所 
人 小: 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.design.widget.AppBarLayout 
android:id="@+id/appBar" 
android:layout_width="match_parent" 
android:layout_height="250dp"> 


<android,.support.design.widget.CollapsingToolbarLayout 
android:id="@+id/collapsing_toolbar" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:contentScrim="?attr/colorPrimary" 
app:layout_scrollFlags="scroll|exitUntilCollapsed"> 

</android.support.design.widget.CollapsingToolbarLayout> 


</android.support.design.widget.AppBarLayout> 


</android.support.design.widget.CoordinatorLayout> 


从 现在 开始 就 稍微 有 点 难 理解 了 ， 这 里 我 们 使 用 了 新 的 布局 
CollapsingToolbarLayout。 其 中 ，id 、1ayout_width 和 1layout_height 这 几 
个 属性 比较 简单 ， 我 就 不 解释 了 。android:theme 属性 指定 了 一 个 
ThemeOverlay.AppCompat.Dark.ActionBar 的 主题 ， 其 实 对 于 这 部 分 我 们 也 并 
不 卫生 ， 因 为 之 前 在 activity_main.xml 中 给 Toolbar 指 定 的 也 是 这 个 主题 ， 
只 不 过 这 里 要 实现 更 加 高 级 的 Toolbar 效 果 ， 因 此 需要 将 这 个 主题 的 指定 提 
到 上 一 层 来 。app:contentscrim 属性 用 于 指定 CollapsingToolbarLayout 在 趋 
于 折合 状态 以 及 折合 之 后 的 背景 色 ， 其 实 CollapsingToolbarLayout 在 折 车 之 
后 就 是 一 个 普通 的 Toolbar， 那 么 背景 色 肯 定 应 该 是 colorPrimary 了 ， 具 体 的 
效果 我 们 待 会 儿 就 能 看 到 ° app:layout_scrollFlags 属性 我 们 也 是 见 过 的 ， 
只 不 过 之 前 是 给 Toolbar 指 定 的 ， 现 在 也 移 到 外 面 来 了 。 其 中 ，scroll 表 示 
CollapsingToolbarLayout 会 随 着 水 果 内 容 详情 的 滚动 一 起 滚动 ， 
exitUntilcollapsed 表示 当 CollapsingToolbarLayout 随 着 深 动 完成 折 芝 之 后 
就 保留 在 界面 上 ， 不 再 移出 屏幕 。 


接 下 来 ， 我 们 在 CollapsingToolbarLayout 中 定义 标题 栏 的 具体 内 容 ， 如 下 所 
小: 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.design.widget.AppBarLayout 
android:id="@+id/appBar" 
android:layout_width="match_parent" 
android:layout_height="250dp"> 


<android,.support.design.widget.CollapsingToolbarLayout 
android:id="@+id/collapsing_toolbar" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:contentScrim="?attr/colorPprimary" 
app:layout_scrollFlags="scroll|exitUntilCollapsed"> 


<ImageView 
android:id="@+id/fruit_image_view" 
android:layout_ width="match_parent" 
android:layout_height="match_parent" 
android:scaleType="centerCrop" 
app:layout_collapseMode="parallax" /> 


<android.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match_parent" 
android:layout_height="?attr/actionBarSize" 
app:layout_collapseMode="pin" /> 
</android.support.design.widget.CollapsingToolbarLayout> 


</android.support.design.widget.AppBarLayout> 


</android.support.design.widget.CoordinatorLayout> 


可 以 看 到 ， 我 们 在 ECollapsingToolbarLayout 中 定义 了 一 个 ImageView 和 一 个 
Toolbar， 也 就 意味 着 ， 这 个 高 级 版 的 标题 栏 将 是 由 普 ; 通 的 标题 村 加 于 图片 
组 合 而 成 的 。 这 里 定义 的 大 多 数 属性 我 们 都 是 见 过 的 ， 瓯 不 再 解释 了 ， 只 
有 一 个 app: layout_collapseMode 比较 卫生 。 它 用 于 指定 当前 控件 在 
CollapsingToolbarLayout 折 县 过 程 中 的 折 县 模式 ， 其 中 Toolbar 指 定 成 pm， 表 
示 在 折 苔 的 过 程 中 位 置 始终 保持 不 变 ，ImageView 指 定 成 parallax， 表 示 会 在 
折 琶 的 过 程 中 产生 一 定 的 错位 偏 黎 ， 这 种 模式 的 视 沉 效果 会 非常 好 。 


这 样 我 们 束 将 水 果 标 题 栏 的 界面 编写 完成 了 ， 下 面 开 始 编写 水 果 内 容 详 情 
部 分 。 继 续 修 改 activity_fruit.xml 中 的 代码 ， 如 下 所 示 : 


<android. support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.design.widget.AppBarLayout 
android:id="@+id/appBar" 
android:layout_width="match_parent" 
android:layout_height="250dp"> 


</android.support.design.widget.AppBarLayout> 


<android,.support.v4.widget.NestedScrollView 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
app:layout_behavior="@string/appbar_scrolling view behavior"> 


</android.support.v4.widget.NestedScrollView> 


</android.support.design.widget.CoordinatorLayout> 


水 果 内 容 详情 的 最 外 层 布局 使 用 了 一 个 NestedScrollView， 注 意 它 和 
AppBarLayout 是 平 级 的 。 我 们 之 前 在 9.2.1 小 节 学 过 ScrollView 的 用 法 ， 它 允 
许 使 用 滚动 的 方式 来 查看 屏幕 以 外 的 数据 ， 而 NestedScrollView 在 此 基础 之 
上 还 增加 了 和 藤 套 响 应 滚动 事件 的 功能 。 由 于 CoordinatorLayout 本 号 已 经 可 以 
响应 滚动 事件 了 ， 因 此 我 们 在 它 的 内 部 就 需要 使 用 NestedScrollView 或 
RecyclerView 这 样 的 布局 。 另 外 ， 这 里 还 通过 app: layout_behavior 属性 指 
定 了 一 个 布局 行为 ， 这 和 之 前 在 RecyclerView 中 的 用 法 是 一 模 一 样 的 。 


不 管 是 ScrollView 还 是 NestedScrollView， 它 们 的 内 部 都 只 允许 存在 一 个 直接 
子 布局 。 因 此 ， 如 果 我 们 想 要 在 里 面 放 入 很 多 东西 的 话 ， 通 常 都 会 先 舱 套 
一 个 LinearLayout， 然 后 再 在 LinearLayout 中 放 入 具体 的 内 容 就 可 以 了 ， 如 下 
所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.v4.widget.NestedScrollView 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
app:layout_behavior="@string/appbar_scrolling_ view behavior"> 


<LinearLayout 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 
</LinearLayout> 


</android.support.v4.widget.NestedScrollView> 


</android.support.design.widget.CoordinatorLayout> 


这 里 我 们 租 套 了 一 个 垂直 方 癌 的 LinearLayonut， 并 将 layout_width 设置 为 


match_parent ， 将 layout_height 设置 为 wrap_content 9 


接 下 来 在 LinearLayout 中 放 入 具体 的 内 容 ， 这 里 我 准备 使 用 一 个 TextView 来 
显示 水 果 的 内 容 详情 ， 并 将 TextView 放 在 一 个 卡片 式 布 局 当中 ， 如 下 所 示 : 


<android. support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.v4.widget.NestedScrollView 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
app:layout_behavior="@string/appbar_scrolling view behavior"> 


<LinearLayout 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:orientation="vertical"> 


<android.support.v7.widget.CardView 
android:layout_ width="match_parent" 


android:layout_height="wrap_content" 
android:layout_marginBottom="1i5dp" 
android:layout_ marginLeft="15dp" 
android:layout_marginRight="15dp" 
android:layout_marginTop="35dp" 
app:cardCornerRadius="4dp"> 


<TextView 
android:id="@+id/fruit_content_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_margin="10dp" /> 
</android.support.v7.widget.CardView> 


</LinearLayout> 
</android.support.v4.widget.NestedScrollView> 


</android.support.design.widget.CoordinatorLayout> 


这 段 代码 也 没有 什么 难 理解 的 地 方 ， 都 是 我 们 学 过 的 知识 。 需 要 注意 的 


是 ， 这 里 为 了 让 界面 更 加 美观 ， 我 在 CardView 和 TextView 上 都 加 了 一 = 
距 。 其 中 ，CardView 的 marginTop 加 了 35dp 的 边 距 ， 这 是 为 面 要 编写 的 东 
西 留 出 空 Es 间 。 


好 的 ， 这 样 就 es phe 不 过 我 们 
还 可 以 在 界面 上 再 添加 一 个 巧 浮 按钮 。 这 个 悬浮 按钮 并 不 是 必需 的 ， 根 据 
具体 的 需求 添加 就 可 以 了 ， 如 果 加 入 的 话 我 们 将 免费 获得 一 些 额 外 的 动 
国 效 果 。 


为 了 做 出 示范 ， 我 束 准 备 在 activity_fruitxml 中 加 入 一 个 巧 浮 按钮 了 。 这 个 
界面 是 一 个 水 果 详 情 展示 界面 ， 那 么 我 陇 加 入 一 个 表示 评论 作用 的 悬浮 按 
钮 吧 。 首先 需 要 提前 准备 好 一 个 图 标 ， 这 里 我 放置 了 一 张 ic_comment.png 到 | 

drawable-xxhdpi 目 录 下 。 然 后 修改 activity_fruit.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<android,.support.design.widget.AppBarLayout 
android:id="@+id/appBar" 
android:layout_width="match_parent" 
android:layout_height="250dp"> 


</android.support.design.widget.AppBarLayout> 


<android,.support.v4.widget.NestedScrollView 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
app:layout_behavior="@string/appbar_scrolling_ view behavior"> 


</android.support.v4.widget.NestedScrollView> 


<android,.support.design.widget.FloatingActionButton 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_margin="16dp" 
android:src="@drawable/ic_comment" 
app:layout_anchor="@id/appBar" 
app:layout_anchorGravity="bottom|end" /> 


</android.support.design.widget.CoordinatorLayout> 


可 以 看 到 ， 这 里 加 入 了 一 个 FloatingActionButton， 它 和 AppBarLayout 以 及 
NestedScrollView 是 平 级 的 。FloatingActionButton 中 使 用 app:1ayout_anchor 
属性 指定 了 一 个 销 点 ， 我 们 将 销 点 设置 为 AppBarLayout， 这 样 基 浮 按钮 整 
会 出 现在 水 果 标 题 栏 的 区 域内 ， 接 着 又 使 用 app:1ayout_anchorGravity 属性 
将 芒 浮 按钮 定位 在 标题 柱 区 域 的 右 下 角 。 其 他 一 些 属性 都 比较 简单 ， 残 不 


再 进行 解释 了 。 


好 了 ， 现 在 我 们 终于 将 整个 activity_ 0 内 容 虽然 比 
较 长 ， 但 由 于 是 分 段 编 写 的 ， 并 且 每 一 步 我 都 进行 了 详细 的 说 明 ， 相 信 你 
应 该 看 得 很 明白 吧 。 


界面 完成 了 之 后 ， 接 下 来 我 们 开始 编写 功能 逻辑 ， 修 改 FruitActivity 中 的 代 
码 ， 如 下 所 示 : 


public class FruitActivity extends AppCompatActivity { 


public static final String FRUIT_NAME = "fruit_name"; 
public static final String FRUIT_IMAGE_ID = "fruit_ image_id",; 


QOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setCcontentView(R.1layout.activity_fruit); 
Intent intent = getIintent(); 
String fruitName = intent.getStringExtra(FRUIT_NAME); 
int fruitImageId = intent.getIintExtra(FRUIT_IMAGE_ID, 0); 
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar); 
CollapsingToolbarLayout collapsingToolbar = (CollapsingToolbarLayout) 
findViewById(R.id.collapsing_toolbar); 
ImageView fruitImageView = (ImageView) findViewById(R.id.fruit_ image_ view); 
TextView fruitContentText = (TextView) findViewById(R.id.fruit _ content_ 
text ) ， 
SetSupportActionBar(toolbar ) ， 
ActionBar actionBar = getSupportActionBar(); 
if (actionBar != nul1) { 
actionBar.setDisplayHomeAsUpEnabled(true); 


collapsingToolbar.setTitle(fruitName); 
Glide.with(this).load(fruitIimageId).into(fruitIimageView); 


String fruitContent = generateFruitCcontent(fruitName ) ， 
fruitContentText ,SetText(fruitCcontent ) ， 
} 


private String generateFruitContent(String fruitName) { 
StringBuilder fruitContent = new StringBuilder(); 
for (int i = 0; i < 500; i++) { 
fruitCcontent ,append(fruitName ) ， 


return fruitContent ,toString()， 


} 


Q@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case android.R.id.home: 
finish(); 
return true; 


return super.onoptionsItemSelected(item); 
} 
} 


FruitActivity 中 的 代码 并 不 是 很 复杂 。 首 先 ， 在 oncreate( ) 方法 中 ， 我 们 通 


过 Intent 获 取 到 传 入 的 水 果 名 和 水 果 图 片 的 资源 id， 多 然后 通过 findviewById() 
方法 拿 到 刚才 在 布局 文件 中 定义 的 各 个 控件 的 实例 。 接 着 残 是 使 用 了 
Toolbar 的 标准 用 法 ， 将 它 作为 ActionBar 显 示 ， 并 局 用 HomeAsUp 按 钮 。 由 
于 HomeAsUp 按 钮 的 默认 图 标 惑 是 一 个 返回 箭头 ， 这 正 是 我 们 所 期 望 的 ， 
此 就 不 用 再 额外 设置 别 的 图 标 了 


接 下 来 开始 填充 界面 上 的 内 容 ， 调 用 CollapsingToolbarLayout 的 setTitle() 
方法 将 水 果 名 设置 成 当前 界面 的 标题 ， 然 后 使 用 Glide 加 载 传 入 的 水 果 图 
卢 ， 并 设置 到 标题 栏 的 ImageView 上 面 。 接着 需要 填充 水 果 的 门 容许 博 ， 由 
于 这 只 是 一 个 示例 程序 ， 并 不 需要 什么 真实 的 数据 ， 所 以 我 使 用 了 一 
generateFruitcontent() 方法 将 水 果 名 循环 拼接 500 次 ， 人 
较 长 的 字符 串 ， 将 它 设 置 到 了 TextView 上 面 。 


后 ， 我 们 在 onoptionsItemselected() 方法 中 处 理 了 HomeAsUp 按 钮 的 点 
击 事件 ， 当 点 击 了 这 个 按钮 时 ， 就 调用 finish() 方法 关闭 当前 的 活动 ， 从 
而 返回 上 一 个 活动 。 


所 有 工作 都 完成 了 吗 ? 其 实 还 差 最 关键 的 一 步 ， 就 是 处 理 RecyclerView 的 点 
击 事 件 ， 不 然 的 话 我 们 根本 就 无 法 打开 FruitActivity。 修 改 FruitAdapter 中 的 
代码 ， 如 下 所 示 : 


public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> { 


Q@Override 
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { 
If (mContext == null) { 
mContext = parent.getContext(); 


View view = LayoutIinflater.from(mContext).inflate(R.]layout.fruit_item, 
parent, false); 
final ViewHolder holder = new ViewHolder (view); 
holder .cardView.setOonClickListener(new View.OnClickListener() { 
Q@Override 
public void onClick(View v) { 
int position = holder.getAdapterPosition(); 
Fruit fruit = mFruitList.get(position); 
Intent intent = new Intent(mContext, FruitActivity.class); 
intent.putExtra(FruitActivity.FRUIT_NAME, fruit.getName()); 
intent.putExtra(FruitActivity.FRUIT_IMAGE_ID, fruit.getImageId()); 
mContext.startActivity(intent),; 
} 
}); 


return holder ， 


最 关键 的 一 步 其 实 也 十 最 简单 的 ， 这 里 我 们 给 CardView 注 册 了 一 个 点 击 事 


件 监 听 器 ， 然 后 在 点 击 事件 中 获取 当前 点 击 项 的 水 果 名 和 水 果 图 片 资 源 id， 
把 它们 传 入 到 Intent 中 ， 最 后 调用 startActivity() 方法 局 动 FruitActivity 。 


见证 奇迹 的 时 刻 到 了 ， 现 在 重新 运行 一 下 程序 ， 并 点 击 界面 上 的 任意 一 
水 果 ， 比 如 我 点 击 了 葡 欧 ， 殖 果 如 图 12.17 所 示 。 
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图 12.17 水 果 的 详情 展示 界面 


你 没有 看 错 ， 如 此 精美 的 界面 就 是 我 们 亲手 敲 出 来 的 。 这 个 界面 上 的 内 容 
分 为 三 部 分 ， 水 果 标 题 栏 、 水 果 内 容 详情 和 巧 浮 按钮 ， 相 信 你 一 眼 就 能 将 
它们 区 分 出 来 吧 。 Toolbar 和 水 果 背 景 图 完美 地 融合 到 了 一 起 ， 既 保证 了 图 
片 的 展示 空间 ， 双 不 影响 Toolbar 的 任何 功能 ， 那 个 向 左 的 第 头 就 是 用 来 返 
同上 一 个 活动 的 


不 过 这 并 不 古 全 部 ， 真 正 的 好 戏 还 在 后 涉 。 我 们 笠 试 同上 拖 动 水 末 内 容 详 
情 ， 你 会 发 现 水 末 百 景 图 上 的 标题 会 慢 慢 缩小 ， 并 且 背 景 图 会 产生 一 些 错 
位 偏 移 的 效果 ， 如 图 12.18 所 示 。 
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图 12.18 ”向 上 拖 动 水 果 内 容 详 情 


这 是 由 于 用 户 想 要 查看 水 果 的 内 容 详情 ， 此 时 界面 的 重点 在 具体 的 内 容 上 
面 ， 因 此 标题 栏 束 会 目 动 进 行 折合， 从 而 广 省 屏幕 空间 。 


继续 向 上 拖 动 ， 直 到 标题 栏 变 成 完全 折合 状态 ， 效 果 如 图 12.19 所 示 。 
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图 12.19 “标题 栏 变 成 完全 折 释 状态 


可 以 看 到 ， 标 题 栏 的 背景 图 片 不 见 了 ， 菊 浮 按 钮 也 目 动 消失 了 ， 现 在 水 果 
标题 栏 变 成 了 一 个 最 普通 的 Toolbar。 这 是 由 于 用 户 正在 阅读 具体 的 内 容 ， 

我 们 需要 给 他 们 提供 最 充分 的 阅读 空间 。 而 如 末 这 个 时 候 向 下 拖 动 水 采 内 
J 距 会 执行 一 个 完全 相反 的 动画 过 程 ， 最 终 恢复 成 图 12.17 的 界面 效 


不 知道 你 有 没有 被 这 个 效果 所 感动 呢 ? 在 这 里 ， 我 真心 地 感谢 Material 
Design 送 给 我 们 的 礼物 。 
12.7.2 ”充分 利用 系统 状态 栏 空间 


虽说 现在 水 果 详 情 展示 界面 的 效果 已 经 非常 华丽 了 ， 但 这 并 不 代表 我 们 不 
能 再 进一步 地 提升 。 观 察 一 下 图 12.17， 你 会 发 现 水 果 的 背景 图 片 和 系统 的 


状态 栏 总 有 一 些 不 搭 的 感觉 ， 如 果 我 们 能 将 背景 图 和 状态 栏 融 合 到 一 起 ， 
那 这 个 视觉 体验 绝对 能 提升 好 儿 个 档次 。 


只 不 过 很 可 惜 的 是 ， 在 Android 5.0 系 统 之 前 ， 我 们 是 无 法 对 状态 栏 的 背景 或 
好色 进 了 操作 的 ， 那 个 时 候 也 还 没有 Material Design 的 概念 。 但 是 Android 
5.0 及 之 后 的 系统 都 是 文 持 这 个 功能 的 ， 因 此 这 里 我 们 就 来 实现 一 个 系统 差 

异型 的 效果 ， 在 Android 5.0 及 之 后 的 系统 中 ， 使 用 背景 图 和 状态 栏 融合 的 模 
式 ， 在 之 前 的 系统 中 使 用 普通 的 模式 。 


想 要 让 育 景 图 能 够 和 系统 状态 栏 融合 ， 需 要 借助 
android:fitssystemwindows 这 个 属 性 来 实现 。 在 CoordinatorLayout 、 
AppBarLayout、CollapsingToolbarLayout 这 种 区 套 结 构 的 布局 中 ， 将 控件 的 
android:fitsSystemwindows 局 属性 指定 成 true ， 就 表示 该 控件 会 出 现在 系统 
状态 柱 里 。 对 应 到 我 们 的 程序 ， 那 就 是 水 果 标 题 栏 中 的 ImageView 以 该 设置 
这 个 属性 了 。 不 、 过 公 给 ImageView 设 置 这 个 属 性 是 没有 用 的 ， 我 们 必须 将 
ImageView 布 局 结构 中 的 所 有 父 布局 都 设置 上 这 个 属性 才 可 以 ， 修 改 
activity_fruit.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:fitsSystemWindows="true"> 


<android,.support.design.widget.AppBarLayout 
android:id="@+id/appBar" 
android:layout_width="match_parent" 
android:layout_height="250dp" 
android:fitsSystemwindows="true"> 


<android,.support.design.widget.CollapsingToolbarLayout 
android:id="@+id/collapsing_toolbar" 
android:layout_ width="match_parent" 
android:layout_height="match_parent" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
android:fitsSystemwWindows="true" 
app:contentScrim="?attr/colorPrimary" 
app:layout_scrollFlags="scroll|exitUntilCollapsed"> 


<ImageView 
android:id="@+id/fruit_image_view" 
android:layout width="match_parent" 
android:layout_height="match_parent" 
android:scaleType="centerCrop" 
android:fitsSystemwindows="true" 
app:layout_collapseMode="parallax" /> 


</android.support.design.widget.CollapsingToolbarLayout> 


</android.support.design.widget.AppBarLayout> 


</android.support.design.widget.CoordinatorLayout> 


但 是 ， 即使 我 们 将 android:fitssystemwindows 属性 都 设置 好 了 还 是 没有 用 
的 ， 因 为 还 必须 在 程序 的 主题 中 将 状态 栏 颜色 指定 成 透明 色 才 行 。 指 定 成 


透明 色 的 方法 很 简单 ， 在 主题 中 将 android:statusBarcolor 属性 的 值 指定 成 
@android:color/transparent 束 可 以 了 人 。 但 问题 在 于 ， 
android:statusBarcolor 这 个 属性 是 从 API 21， 也 就 是 Android 5.0 系 统 开始 
才 有 的 ， 之 耳 的 么 4 党 无 法 指定 这 个 属性 。 那 么 ， 系 统 差异 型 的 功能 实现 就 
要 从 这 里 开始 了 


右 击 res 目 录 一 New 一 Directory， 创 建 一 个 values-v21 目 录 ， 然 后 右 击 values- 
V21 目 好-New 一 Values resource file， 创 建 一 个 Mi 接着 对 这 个 
文件 进行 编写 ， 代 码 如 下 所 示 : 


<resources> 


<style name="FruitActivityTheme" parent="AppTheme"> 
<item name="android:statusBarColor">@android:color/transparent</item> 
</style> 


</resources> 


这 里 我 们 定义 了 一 个 FruitActivityTheme 主 题 ， 呈 是 专 门 给 FruitActivity 使 用 
的 。FruitActivityTheme 的 parent 主 题 是 AppTheme， 也 就 是 说 ， 它 继承 了 
AppTheme 中 的 所 有 特性 。 然 后 我 们 在 FruitActivityTheme 中 将 状态 栏 的 颜色 
指定 成 透明 色 ， 由 于 values-v21 目 录 是 只 有 Android 5.0 及 以 上 的 系统 才 会 去 
读 取 的 ， 因 此 这 么 声明 是 没有 问题 的 。 


但 是 Android 5.0 之 前 的 系统 却 无 法 识 别 FruitActivityTheme 这 个 主题 ， 因 此 我 
们 还 需要 对 values/styles.xml 文 件 进 行 修改 ， 如 下 所 示 : 


<resources> 
<!-- Base application theme. --> 
<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar"> 
<!-- Customize your theme here. --> 


<item name="colorPrimary">@color/colorPrimary</item> 
<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 

</style> 


<style name="FruitActivityTheme" parent="AppTheme"> 
</style> 


</resources> 


可 以 看 到 ， 这 里 也 定义 了 一 个 FruitActivityTheme 主 题 ， 并 且 parent 主 题 也 是 
AppTheme， 但 是 它 的 内 部 是 空 的 。 因 为 Android 5.0 之 前 的 系统 无 法 指定 状 
态 栏 的 颜色 ， 因 此 这 里 什么 都 不 用 做 就 可 以 了 。 


， 我 们 还 需要 让 FruitActivity 使 用 这 个 主题 才 可 以 ， 修 改 
人 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.materialtest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<activity 
android:name=" .FruitActivity" 
android:theme="@style/FruitActivityTheme"> 
</activity> 
</application> 


</manifest> 


这 里 使 用 android:theme 属性 单独 给 FruitActivity 指 定 了 FruitActivityTheme 这 
个 主题 ， 这 样 我 们 就 大 功 告 成 了 。 


现在 只 要 是 在 Android 5.0 及 以 上 的 系统 运行 MaterialTest 程 序 ， 水 果 详 情 展 示 
界面 的 效果 就 会 如 图 12.20 所 示 。 
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图 12.20 背景 图 和 状态 栏 融合 的 效果 


"0 再 对 比 一 下 图 12.17 的 效果 ， 这 两 种 视觉 体验 绝对 不 是 在 一 个 档次 
上 的 。 


12.8 小 结 与 尽 评 


学 完了 本 章 的 所 有 知识 ， 你 有 没有 觉得 无 比 兴 奋 呢 ?反正 我 是 这 么 觉得 
的 。 本 章 我 们 的 收获 实在 是 太 多 了 ， 从 一 个 什么 都 没有 的 空 项 目 ， 经 过 一 
章 的 学 习 ， 最 后 实现 了 一 个 功能 如 此 丰富 、 界 面 如 此 华丽 的 应 用 ， 还 有 什 
么 事情 比 这 个 更 让 我 们 有 成 就 感 吗 ? 


本 章 中 我 们 充分 利用 了 Design Support 库 、support-v4 库 、 appcompat- -V7 库 ， 
以 及 一 些 开源 项 目 来 实现 一 个 了 高 度 Material 化 的 应 用 程序 ， 能 将 这 些 库 中 


的 相关 控件 熟练 掌握 ， 你 的 Material Design 技 术 就 算是 合格 了 。 


不 过 说 到 底 ， 我 仍然 还 是 在 以 一 个 开发 者 的 思维 给 你 讲解 Material Design， 
侧重 于 如 何 去 实 现 这 些 效果 。 而 实际 上 ，Material Design 的 设计 思维 和 设计 
理念 才 是 更 加 重要 的 东西 ， 当 然 这 部 分 内 容 应 该 是 UI 设计 人 员 去 学 习 的 ， 
如 果 你 也 感 兴趣 的 话 ， 可 以 参考 一 下 Material Design 的 官方 文章 : 


https://material.google.com ° 


现在 你 已 经 足 足 学 习 了 12 半 的 内 容 ， 对 Android 应 用 程序 开发 的 理解 应 该 比 
较 深 刻 了 。 目 前 系统 性 的 知识 几乎 都 已 经 讲 完了 ,但 是 还 有 一 些 零散 的 高 
级 技巧 在 等 待 着 你 ， 那 么 束 让 我 们 赶快 进入 到 下 一 章 的 学 习 当 中 吧 。 


第 13 章 ”继续 进 阶 
握 的 高 级 技巧 


本 书 的 内 容 虽 然 已 经 接近 尾声 了 ， 但 是 干 万 不 要 因此 而 放松 ， 现 在 正 是 你 
继续 进 阶 的 时 机 。 相 信 基 础 性 的 Android 知 识 已 经 没有 太 多 能 够 难 倒 你 的 
了 ， 那 么 本 章 中 我 们 束 来 学 习 一 些 你 还 应 该 掌握 的 高 级 技巧 吧 。 


13.1 全 局 获取 Context 的 技巧 


回想 这 么 久 以 来 我 们 所 学 的 内 容 ， 你 会 发 现 有 很 多 地 方 都 需要 用 到 


你 还 应 该 党 


或 许 目前 你 还 没有 为 得 不 到 context 而 发 狼 过 ， 因 为 我 们 很 多 的 操作 都 是 在 
活动 中 进行 的 ， 而 活动 本 身 就 是 一 个 context 对 象 。 但 是 ， 当 应 用 程序 的 架 
构 逐 渐 开 始 复杂 起 来 的 时 候 ， 很 多 的 逻辑 代码 都 将 脱离 Activity 类 ， 但 此 
时 你 又 恰恰 需要 使 用 context ， 也 许 这 个 时 候 你 殉 会 感到 有 些 伤 脑筋 了 。 


举 个 例子 来 说 吧 ， 在 第 9 章 的 最 佳 实践 环 世 ， 我 们 编写 了 一 个 Httputil 类 ， 
在 这 里 将 一 些 通 用 的 网 络 操 作 封装 了 起 来 ， 代 码 如 下 所 未: 


public class HttpUtil { 


public static void sendHttpRequest(final String address, final 
HttpCallbackListener listener) { 
new Thread(new Runnable() { 
@Override 
public void run() { 
HttpURLConnection connection = null; 
try { 

URL url = new URL(address); 

connection = (HttpURLConnection) url.openConnection(); 

connection.setRequestMethod("GET"); 

connection.setConnectTimeout(8000); 

connection.setReadTimeout(8000); 

connection,.setDoInput(true); 

connection,.setDoOutput(true); 

InputStream in = connection.getInputStream(); 

BufferedReader reader = new BufferedReader(new 
InputStreamReader (in)); 

StringBuilder response = new StringBuilder(); 

String line; 

while ((line = reader.readLine()) != null) { 
response.append(line); 


} 

if (listener != null) { 
// 回调 onFinish( ) 方 法 
listener.onFinish(response.toString()); 


} 
} catch (Exception e) { 
if (listener != null) { 
// 回调 onError( ) 方 法 
listener.onError(e); 


} 
} finally { 
if (connection != null) { 
connection.disconnect(); 
} 


} 


} 
}).start(); 


这 里 使 用 sendHttpRequest() 方法 来 发 送 HTTP 请 求 显然 是 没有 问题 的 ， 并 
且 我 们 还 可 以 在 回调 方法 中 处 理 服务 器 返回 的 数据 。 但 现在 我 们 想 对 
sendHttpRequest() 方法 进行 一 些 优化 ， 当 检测 到 网 络 不 存在 的 时 候 就 给 用 
户 一 个 Toast 提 示 ， 并 且 不 再 执行 后 面 的 代码 。 看 似 一 个 挺 简单 的 功能 ， 可 
是 却 存在 一 个 让 人 头疼 的 问题 ， 弹 出 Toast 提 示 需要 一 个 context 参数 ， 而 我 
们 在 Httputil 类 中 显然 是 获取 不 到 context 对 象 的 ， 这 该 怎么 办 呢 ? 


其 实 要 想 快 速 解 决 这 个 问题 也 很 答 单 ， 大 不 了 在 sendHttpRequest() 方法 中 
添加 一 个 context 参数 就 行 了 哪 ， 于 是 可 以 将 Httputil 中 的 代码 进行 如 下 修 
改 : 


public class HttpUtil { 


public static void sendHttpRequest(final Context context, 
final String address, final HttpCallbackListener listener) { 
If (!isNetworkAvailable()) { 
Toast.makeText(context, "network is unavailable", 
Toast .LENGTH_SHORT) .show( ) ， 
return， 


new Thread(new Runnable() { 
Q@Override 
public void run() { 


} 
}).start(); 


private static boolean isNetworkAvailable() { 


} 


可 以 看 到 ， 这 里 在 方法 中 添加 了 一 个 context 参数 ， 并 且 假 设 有 一 个 
isNetworkAvailable() 方法 用 于 判断 当前 网 络 是 否 可 用 ， 如 果 网 络 不 可 用 的 
话 就 弹出 Toast 提 示 ， 并 将 方法 return 挥 。 


虽说 这 也 确实 是 一 种 解决 方案 ， 但 是 却 有 点 推 抒 责任 的 嫌疑 ， 因 为 我 们 将 
获取 Context 的 件 各 村 物 妈 sendHiEDRenuestt) 方法 的 调用 方 ， 至 于 调用 
方 能 不 能 得 到 context 对 象 ， 那 就 不 是 我 们 需要 考虑 的 问题 了 。 


由 此 可 以 看 出 ， 在 某 些 情况 下 ， 获 取 context 并 非 是 那么 容易 的 一 件 事 ， 有 
时 候 还 是 挺 伤 脑筋 的 。 不 过 别 担心 ， 下 面 我 们 就 来 学 习 一 种 技巧 ， 让 你 在 
项 目的 任何 地 方 都 能 够 轻松 获取 到 context 。 


Android 提 供 了 一 个 Application 类 ， 每 当 应 用 程序 局 动 的 时 候 ， 系 统 束 会 目 
动 将 这 个 类 进行 初始 化 。 而 我 们 可 以 定制 一 个 目 己 的 Application 类 ， 以 便 
于 管理 程序 内 一 些 全 局 的 状态 信息 ， 比 如 说 全 局 context 。 


定制 一 个 自己 的 Application 其 实 并 不 复杂 ， 首 先 我 们 需要 创建 一 个 
MyApplication 类 继承 目 Application ， 代 码 如 下 所 示 : 


public class MyApplication extends Application { 


private static Context context; 


QOverride 
public void onCreate() { 
context = getApplicationContext(); 


} 


public static Context getContext() { 
return context; 
} 


可 以 看 到 ，wyApplication 中 的 代码 非常 简单 。 这 里 我 们 重 写 了 父 类 的 
oncreate() 方法 ， 并 通过 调用 getApplicationcontext() 方法 得 到 了 一 个 应 
用 程序 级 别 的 context ， 人 然后 又 提供 了 一 个 静态 的 getcontext() 方法 ， 在 这 
里 将 刚才 获取 到 的 context 进行 返回 。 


接 下 来 我 们 需要 告知 系统 ， 当 程序 启动 的 时 候 应 该 初始 化 MyApplication 
类 ， 而 不 是 默认 的 Application 类 。 这 一 步 也 很 简单 ， 在 
AndroidManifest.xml 文 件 的 <application> 标签 下 进行 指定 束 可 以 了 ， 代 码 
如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.networktest" 
android:versionCode="1" 
android:versionName="1.0" > 


<application 
android:name="com.example.networktest.MyApplication" 


a 


</application> 
</manifest> 


主意 这 里 在 指定 MyApplication 的 时 候 一 定 要 加 上 完整 的 包 名 ， 不 然 系统 将 
无 法 找到 这 个 类 。 

这 样 我 们 就 已 经 实现 了 一 种 全 局 获取 context 的 机 制 ， 之 后 不 管 你 想 在 项 目 
的 任何 地 方 使 用 context ， 只 需要 调用 一 MMyApplication.getcontext() 就 
可 以 了 。 


那么 接 下 来 我 们 再 对 sendhttpRequest() 方法 进行 优化 ， 代 码 如 下 所 示 : 


一 < 


public static void sendHttpRequest(final String address, final HttpCallbackListener 
Jistener) { 
if (!isNetworkAvailable()) { 
Toast.makeText (MyApplication.getContext(), "network is unavailable", 
Toast .LENGTH_SHORT) .show( ); 
return; 


可 以 看 到 ，sendHttpRequest() 方法 不 需要 再 通过 传 参 的 方式 来 得 到 context 


对 象 ， 而 是 调用 一 下 MyApplication.getcontext() 方法 就 可 以 了 。 有 了 这 个 
技巧 ， 你 再 也 不 用 为 得 不 到 context 对 象 而 发 悉 了 。 


然后 我 们 再 回顾 一 下 6.5.2 小 和 学 过 的 内 容 ， 当 时 为 了 让 LitePal 可 以 正常 工 
作 ， 要 求 必须 在 AndroidManifest,.xzml 中 配置 如 下 内 容 : 


<application 
android:name="org.litepal.LitePpalApplication" 
i 


</application> 


其 实 道 理 也 是 一 样 的 ， 因 为 经 过 这 样 的 配置 之 后 ，LitePal 就 能 在 内 部 目 动 
获取 到 context 了 。 


不 过 这 里 你 可 能 又 会 产生 疑问 ， 如 果 我 们 已 经 配置 过 了 自己 的 Application 
怎么 办 ? 这 样 岂 不 是 和 LitepPalApp1lication 冲突 了 ? 没 错 ， 任何 一 个 项 目 
都 只 能 配置 一 个 Application ， 对 于 这 种 情况 ，LitePal 提 供 了 很 简单 的 解决 
方案 ， 那 就 是 在 我 们 自己 的 Application 中 去 调用 LitePal 的 初始 化 方法 就 可 
以 TO/ 汪汪 外 


public class MyApplication extends Application { 
private static Context context; 


QOverride 

public void onCreate() { 
context = getApplicationContext(); 
LitePal.initialize(context ) ， 


} 


public static Context getContext() { 
return context; 


使 用 这 种 写法 ， 融 相当 于 我 们 把 全 局 的 context 对 象 通 过 参数 传递 给 
LitePal， 戏 果 和 在 AndroidManifest.xml 中 配置 LitepPalApplication a 
样 的 。 


13.2 ”使 用 Intent 传 递 对 象 


Intent 的 用 法 相信 你 已 经 比较 熟悉 了， 我 们 可 以 借助 它 来 启动 活动 、 发 送 广 
播 、 局 动 服务 等 。 在 进行 上 述 操 作 的 时 候 ， 我 们 还 可 以 在 Intent 中 添加 一 些 
附加 数据 ， 以 达到 传 值 的 效果 ， 比 如 在 FirstActivity 中 添加 如 下 代码 : 


Intent intent = new Intent (FirstActIVitYy: this, SecondActivity.class); 
intent. Bl EC ra string_data", "hello"); 

intent.putExtra("int_data" 100); 

startActivity(intent); 


这 里 调用 了 Intent 的 putExtra( ) 方法 来 添加 要 传递 的 数据 ， 之 后 在 
secondActivity 中 就 可 以 得 到 这 些 值 了 ， 代 码 如 下 所 示 : 


getIintent().getSstringExtra("string_data"); 
getIintent().getIntExtra("int_data", 0); 


但 是 不 知道 你 有 没有 发 现 ，putExtra() 方法 中 所 文 持 的 数据 类 型 是 有 限 


的 ， 虽 然 常 用 的 一 些 数据 类 型 它 都 会 文 持 ， 但 是 当 你 想 去 传递 一 些 目 定 义 
对 象 的 时 候 ， 束 会 发 现 无 从 下 手 。 不 用 担心 ， 下 面 我 们 残 学 习 一 下 使 用 
Intent 来 传递 对 象 的 技巧 。 


13.2.1 Serializable 方 式 


使 用 Intent 来 传递 对 象 通常 有 两 种 实现 方式 : Serializable 和 Parcelable， 本 小 
节 中 我 们 先 来 学 习 一 下 第 一 种 实现 方式 。 


Serializable 是 序列 化 的 意思 ， 表 示 将 一 个 对 象 转换 成 可 存储 或 可 传输 的 状 
仿 。 厅 列 化 后 的 对 黎 避 忆 在 网 络 上 进行 传 轩 ， 也 可 以 存储 到 本 地 。 至 于 序 
列 化 的 方法 也 很 简单 ， 只 需要 让 一 个 类 去 实现 serializable 这 个 接口 就 可 
以 了 。 


比如 说 有 一 个 Person 类 ， 其 中 包含 了 name 和 age 这 两 个 字段 ， 想 要 将 它 友 
列 化 就 可 以 这 样 写 : 


public class Person implements Serializablef{ 
private String name; 
private int age; 
public String getName() { 


return name; 
} 


public void setName(String name) { 
this.name = name; 
} 


public int getAge() { 
return age; 
} 


public void setAge(int age) { 
this.age = age; 


其 中 ，get 、set 方法 都 是 用 于 赋值 和 读 取 字段 数据 的 ， 最 重要 的 部 分 是 在 


第 一 行 。 这 里 让 Person 类 去 实现 了 serializable 接口 ， 这 样 所 有 的 Person 
对 象 就 都 是 可 序列 化 的 了 。 


接 下 来 在 FirstActivity 中 的 写法 非常 简单 : 


Person person = new Person() 

person.setName("Tom"); 

person.setAge(20); 

Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
intent.putExtra("person_data", person); 

startActivity(intent); 


可 以 看 到 ， 这 里 我 们 创建 了 一 个 Person 的 实例 ， 然 后 就 直接 将 它 传 入 到 
putExtra() 方法 中 了 。 由 于 Person 类 实现 了 serializable 接口 ， 所 以 才 可 
以 这 样 写 。 


接 下 来 在 secondActivity 中 获取 这 个 对 象 也 很 徐 单 ， 写 法 如 下 : 
Person person = (Person) getIintent().getSerializableExtra("person _ data"); 


| | 


这 里 调用 了 getserializableExtra() 方法 来 获取 通过 参数 传递 过 来 的 序列 化 
对 象 ， 接 着 再 将 它 向 下 转型 成 Pearson 对 象 ， 这 样 我 们 就 成 功 实现 了 使 用 
Intent 来 传递 对 象 的 功能 


13.2.2 ”Parcelable 方 式 


除了 Serializable 之 外 ， 使 用 Parcelable 也 可 以 实现 相同 的 效果 ， 不 过 不 同 于 将 
对 象 进 行 序列 化 ，Parcelable 方 式 的 实现 原理 是 将 一 个 完整 的 对 象 进 行 分 
iE 的 每 一 部 分 都 是 Intent 所 支持 的 数据 类 型 ， 这 样 也 就 实现 传递 
对 象 的 功能 了 。 


下 面 我 们 来 看 一 下 Parcelable 的 实现 方式 ， 修 改 Person 中 的 代码 ， 如 下 所 
人 小 : 


的 


public class Person implements Parcelable { 


private String name; 


private int age; 


Q@Override 

public int describeContents() { 
return 0 ); 

} 


QOverride 

public void writeToParcelL(Parcel dest, int flags) { 
dest.writestring(name); // 写 出 name 
dest.writeInt(age); // 写 出 age 


} 


public static final Parcelable.Creator<Person> CREATOR = new Parcelable. 
Creator<Person>() { 


Q@Override 

public Person createFromPparcel(Parcel source) { 
Person person = new Person(); 
person.name = source.readString(); // 读 取 name 
person.age = source.readInt(); // 读 取 age 
return person; 


} 


Q@Override 
public Person[] newArray(int size) { 
return new Person[sizel]; 


| 


Parcelable 的 实现 方式 要 稍微 复杂 一 些 。 可 以 看 到 ， 上 前 先 我 们 让 person 类 去 
实现 了 Parcelable 接口 ， 这 样 束 必 须 重 写 describecontents() 和 
writeToParcel( ) 这 两 个 方法 。 其 中 describecontents() 方法 直接 返回 0 驶 可 
以 了 ， 而 writeToParcel() 方法 中 我 们 需要 调用 Parcel 的 writexxx() 方法 ， 

将 person 类 中 的 字段 一 一 写 出 。 注 意 ， 字 符 串 型 数据 就 调用 writestring() 
方法 ， 整 型 数据 束 调 用 writeInt() 方法 ， 以 此 类 推 。 


除 此 之 外 ， 我 们 还 必须 在 Person 类 中 提供 一 个 名 为 cREATOR 的 常量 ， 这 里 创 
建 了 parcelable.Creator 接口 的 一 个 实现 ， 并 将 泛 型 指定 为 person 。 接 着 
需要 重 写 createFromparcel() 和 newArray() 这 两 个 方法 ， 在 
createFromParcel() 方法 中 我 们 要 去 读 取 刚才 写 出 的 name 和 age 字段 ， 并 创 
建 一 个 Person 对 象 进行 返回 ， 其 中 name 和 age 都 是 调用 parcel 的 readxxx() 
方法 读 取 到 的 ， 注 意 这 里 读 取 的 顺序 一 定 要 和 刚才 写 出 的 顺序 完全 相同 。 
而 newArray() 方法 中 的 实现 就 简单 多 了 ， 只 需要 new 出 一 个 Person 数组 ， 并 
使 用 方法 中 传 入 的 size 作 为 数组 大 小 就 可 以 了 。 


接 下 来 ， 在 FirstActivity 中 我 们 仍然 可 以 使 用 相同 的 代码 来 传递 person 对 
象 ， 只 不 过 在 secondActivity 中 获取 对 象 的 时 候 需 要 稍 加 改动 ， 如 下 所 
人 小 : 


Person person = (Person) getIntent().getPparcelableExtra("person_data"); 


注意 ， 这 里 不 再 是 调用 getsSerializableExtra() 方法 ， 而 是 调用 
getParcelableExtra( ) 方法 来 获取 传递 过 来 的 对 象 了 ， 其 他 的 地 方 都 完全 相 
同 o 


这 样 我 们 就 把 使 用 Intent 来 传递 对 象 的 两 种 实现 方式 都 学 习 完 了 ， 对 比 一 
下 ，Serializable 的 方式 较为 简单 ， 但 由 于 会 把 整个 对 象 进行 序列 化 ， 因 此 效 
率 会 比 Parcelable 方 式 低 一 些 ， 所 以 在 通常 情况 下 还 是 更 加 推荐 使 用 
Parcelable 的 方式 来 实现 Intent 传 递 对 象 的 功能 


13.3 ”定制 目 己 的 日 志 工 具 


早 在 第 1 章 的 1.4 节 中 我 们 就 已 经 学 过 了 Android 日 志 工 具 的 用 法 ， 并 且 日 志 
工具 也 确实 贯 罕 了 我 们 整 本 书 的 学 习 ， 基 本 上 每 一 革 都 有 用 到 过 。 虽 然 
Android 中 目 读 的 日 志 工 具 功 能 非常 强大 ， 但 也 不 能 说 是 完全 没有 缺 氮 ， 例 
如 在 打印 日 志 的 控制 方面 束 做 得 不 够 好 。 


打 个 比方 ， 你 正在 编写 一 个 比较 庞大 的 项 目 ， 期 间 为 了 方便 调试 ， 在 代码 
的 很 多 地 方 都 打印 了 大 量 的 日 志 。 最 近 项 目 已 经 基本 完成 了 ， 但 是 却 有 一 
个 非常 让 人 头疼 的 问题 ， 之 前 用 于 调试 的 那些 日 志 ， 在 项 目 正式 上 线 之 后 
仍然 会 照 第 打印 ， 这 样 不 仅 会 降低 程序 的 运行 效率 ， 还 有 可 能 将 一 些 机 密 
性 的 数据 泄露 出 去 。 


那 该 怎么 办 呢 ? 难道 要 一 行 一 行 地 把 所 有 打印 日 志 的 代码 都 删 挥 ? 显然 这 
不 是 什么 好 点 于， 不 仅 费时 费力 ， 而 且 以 后 你 继续 维护 这 个 项 目的 时 候 可 
能 还 会 需要 这 些 日 志 。 因 此 ， 最 理想 的 情况 是 能 够 自由 地 控制 日 志 的 打 

0 
志 屏 蔽 挥 。 


看 起 来 好 像 是 挺 高 级 的 一 个 功能 ， 其 实 并 不 复杂 ， 我 们 只 需要 定制 一 个 目 
己 的 日 志 工具 就 可 以 轻松 完成 了 。 比 如 新 建 一 个 Logutil 类 ， 代 码 如 下 所 
人 小: 


public class LogUtil { 


public static final int VERBOSE = 1; 

public static final int DEBUG = 2; 

public static final int INFO = 3; 

public static final int WARN = 4; 

public static final int ERROR = 5; 

public static final int NOTHING = 6; 

public static int level = VERBOSE,; 

public static void v(String tag, String msg) { 
if (level <= VERBOSE) { 


Log.v(tag, msg); 


} 


public static void d(String tag, String msg) { 
if (level <= DEBUG) { 
Log.d(tag, msg); 


} 
public static void i(String tag, String msg) { 


if (level <= INFO) { 
Log.i(tag, msg); 


和 
} 


public static void w(String tag, String msg) { 
If (level <= WARN) { 
Log.w(tag, msg); 
} 
} 


public static void e(String tag, String msg) { 
if (level <= ERROR) { 
Log.e(tag, msg); 
} 
} 


可 以 看 到 ， 我 们 在 Logutil 中 先是 定义 了 VERBOSE 、DEBUG 、INFO 、WARN 、 
ERROR 、NOTHING 这 6 个 整 型 常量 ， 并 且 它 们 对 应 的 值 都 是 递增 的 。 然 后 又 定 
义 了 一 个 静态 变量 level ， 可 以 将 它 的 值 指定 为 上 面 6 个 常量 中 的 任意 一 


个 。 


接 下 来 我 们 提供 了 v()、d()、i()、w()、e() 这 5 个 目 定义 的 日 志方 法 ， 
在 其 内 部 分 别 调用 了 Log. Vv() 、Log.d() 、Log.i() 、Log.w() 、 Log. e() 这 5 
个 方法 来 打印 日 志 ， 只 不 过 在 这 些 自 定义 的 方法 中 我 们 都 加 入 了 一 个 if 判 
上 条， 只 有 当 level 的 值 小 于 或 等 于 对 应 日 志 级 别 值 的 时 候 ， 才 会 将 日 志 打 印 
出 来 。 


这 样 就 把 一 个 自 定义 的 日 志 工 具 创 建 好 了 ， 之 后 在 项 目 里 我 们 可 以 像 使 用 
普通 的 日 志 工具 一 样 使 用 Logutil ， 比 如 打印 一 行 DEBUG 级 别 的 日 志 就 可 
以 这 样 写 : 


LogUtil.d("TAG", "debug 1og") ， 


打印 一 行 WARN 级 别 的 日 志 束 可 以 这 样 写 


LogUtil.w("TAG", "warn lo0g"); 


然后 我 们 只 需要 修改 level 变量 的 值 ， 就 可 以 自由 地 控制 日 志 的 打印 行为 
了 。 比 如 让 level 等 于 VERBOSE 束 可 以 把 所 有 的 日 志 都 打印 出 来 ， 让 level 


等 于 WARN 就 可 以 只 打印 警告 以 上 级 别 的 日 志 ， 让 level 等 于 NOTHING 就 可 以 
把 所 有 日 志 都 屏蔽 挥 。 


使 用 了 这 种 方法 之 后 ， 刚 才 所 说 的 那个 问题 就 不 复 存 在 了 ， 你 只 需要 在 开 
发 阶段 将 level 指定 成 vVERBOSE ， 当 项 目 正 式 上 线 的 时 候 将 level 指定 成 
NOTHING 就 可 以 了 。 


13.4 ”调试 Android 程 序 


当 开 发 过 程 中 遇 到 一 些 奇 怪 的 bug， 但 又 迟到 定位 不 出 来 原因 是 什么 的 时 
候 ， 最 好 的 解决 办 法 束 是 调试 了 。 调 试 允许 我 们 逐 行 地 执行 代码 ， 并 可 以 
实时 观察 内 存 中 的 数据 ， 从 而 能 够 比较 轻易 地 查 出 问题 的 原因 。 那 么 本 市 
中 我 们 就 来 学 习 一 下 使 用 Android Studio 来 调试 Android 程 序 的 技巧 。 


还 记得 在 第 5 章 的 最 佳 实践 环节 中 编写 的 那个 强制 下 线程 序 吗 ? 就 让 我 们 通 
过 这 个 例子 来 学 习 一 下 Android 程 序 的 调试 方法 吧 。 这 个 程序 中 有 一 个 登录 
功能 ， 比 如 说 现在 登录 出 现 了 问题 ， 我 们 就 可 以 通过 调试 来 定位 问题 的 原 


不 用 多 说 ， 调 试 工作 的 第 一 步 肯 定 是 深 加 断 点 ， 这 里 由 于 我 们 要 调试 登录 
部 分 的 回 题 ， 所 以 断 点 可 以 加 在 登录 按钮 的 点 击 事件 里 面 。 添 加 断 点 的 方 
法 也 很 简单 ， 只 需要 在 相应 代码 行 的 左边 点 击 一 下 残 可 以 了 ， 如 图 13.1 所 
示 “。 


Login = (Button) findViewById(R. id. login); 
Login,.setOnClickListener(new View.OnClickListener() { 


G0verride 
@l public void onClick(View v) { 
加 String account = accountEdit.getText().toString() ; 


String password = passwordEdit.getText().toString(); 


图 13.1 添加 断 点 
如 果 想 要 取消 这 个 断 点 ， 对 着 它 再 次 点 击 就 可 以 了 。 
添加 好 了 断 点 ， 接 下 来 就 可 以 对 程序 进行 调试 了 ， 点 击 Android Studio 顶 部 


(图 13.2 中 最 右边 的 按钮 ) ， 就 会 使 用 调试 模式 来 启 
动 程序 。 


Cappz| wp 菲 


图 13.2 调试 按钮 
等 到 程序 运行 起 来 的 时 候 ， 首 先 会 看 到 一 个 提示 框 ， 如 图 13.3 所 示 。 


tM 1:09 


Waiting For Debugger 


Application 

BroadcastBestPractice (process 
com.example.broadcastbestpractice) is 
waiting for the debugger to attach. 


FORCE CLOSE 


图 13.3 等待 调试 器 提示 框 


这 个 框 很 快 就 会 自动 消失 ， 然 后 在 输入 框 里 输入 账号 和 密码 ， 并 点 击 Login 
按钮 ， 这 时 Android Studio 束 会 目 动 打开 Debug 窗 口 ， 如 图 13.4 所 示 。 


overrlide | 
| 明 protected void onCreatelBundle savedInstanceState) { 
super.onCreate(savedIinstanceState); | 
setContentView(R, layout .activity_login); 
accountEdit = (EditText) findViewById(R, id,account); 
passwordEdit = (EditText) findViewById(R. id.,password); 
login = (Button) findViewById(R.id. login); | 
login, setOnClickListener(new View.OnClickListener() { 
@Override | 
时 public void onClick(View v) { v: “android.support.v7.widget.AppCompatButton{le9asld VF5D..C.。...P...。 Be,368-1888.548 
String account = accountEdit.getText(),.toString(); 
String password = passwordEdit.getText().toString(); | 
if (account.equals("admin") 5 password, equals("123456")) { 和 
Intent intent = new Intent(LoginActivity, this, MainActivity. cless); 
StartActivity(intent); 
finish(); 
} else { 
Toast.mokeText (LoginActivity, this, "account or password is invalid", 
Toast. LENGTH_SHORT).. show( ); 


} 
} 
»); 
| } 
(Debvg Bapp i 次 - 之 | 
及 | Debuoger | 加 Console ** 滞 王 兰 关 到 沽 站 回 二 奈 | 
| 辣 有 … 至 varbbles 加 


| | | sl1N 
| 加 BD "main"@3,975 in group “main”;... | 全 FI? 三 ths= {LoginActvitys1@4318 

* 至 v = {IAppCompatBunonD4320] "androld.supporLv7.wid9geLAppCompatBueonfle9a35 View 
pb é passwordEdit = IAppCompatEdirTextD4324j) "android.support.v7.widget.AppComp . View| 
> dwr"accountEdit = [AppCompatEdiText®4325) "androld.supporLv7.widgeLAppCompat View| 


| 
| 
| 


@: LoginActivity$ 1 (com.example.broadcastbestpr. 
多 performClickO0:5204, View (android.view) 
run0:21153, ViewS$PerformClick (android.view) 
| 四 | handiecallback0:739, Handler (android.os) 
| dispatchMessage0:95, Handier (android.o5) 
| 灸 ioop0:148, Looper {android.o0s) 
| | main0:5417, ActvityThread (android.app) 
FS 


imvoke0;-1, Method (java,lang.refiecy 
run0:726, Zygoteinits MethodAndArgsCaller (com.android. ng 
TEN | 


Dalai Lo edd 


图 13.4 Debug 窗口 


接 下 来 每 按 一 次 F8 健 ， 代 人 码 就 会 同 下 执行 一 行 ， 并 且 通 过 Variables 视 图 还 可 
以 看 到 内 存 中 的 数据 ， 如 图 13.5 所 示 。 


三 Variables +" 


pb 室 this = {LoginActivity$ 1@4318} 
pb 一 v= {AppCompatButton@4320} "android.support.v7.widget.AppCompatButton{le9a’'... View 
bp 宇 account = "abc" 

* 室 password = "123" 


图 13.5 Variables 视 图 


可 以 看 到 ， 我 们 从 输入 框 里 获取 到 的 账号 密码 分 别 是 abc 和 123， 而 程序 里 
要 求 正确 的 账号 密码 是 admin 和 123456， 所 以 登录 才 会 出 现 问 题 。 这 样 我 们 


束 通 过 调试 的 方式 轻松 地 把 问题 定位 出 来 了 ， 调 试 完 成 之 后 点 击 Debug 窗 口 
中 的 Stop 按 钮 〈 图 13.6 中 最 下 边 的 按钮 ) 来 结束 调试 即 可 。 


多 
局 


图 13.6 ”结束 调试 按钮 


这 种 调试 方式 虽然 完全 可 以 正常 工作 ， 但 在 调试 模式 下 ， 程 序 的 运行 效率 
将 会 大 大 地 降低 ， 如 果 你 的 断 点 加 在 一 个 比较 靠 后 的 位 置 ， 需 要 执行 很 多 
的 操作 才能 运行 到 这 个 断 点 ， 那 么 前 面 这 些 操作 束 都 会 有 一 些 卡 顿 的 感 
觉 。 没 关系 ，Android 还 提供 了 另外 一 种 调试 的 方式 ， 可 以 让 程序 随时 进入 
到 调试 模式 ， 下 面 我 们 束 来 笑 试 一 下 。 


这 次 不 需要 选择 调试 模式 来 启动 程序 了 ， 就 使 用 正常 的 方式 来 启动 程 序 。 

由 于 现在 不 是 在 调试 模式 下 ， 程 序 的 运行 速度 比较 快 ， 可 以 先 把 账号 和 密 
码 输入 好 。 然 后 点 击 Android Studio 顶 部 工具 栏 的 Attach debugger to Android 
process 按 钮 〈 图 13.7 中 最 左边 的 按钮 ) 。 


压 所 国 


图 13.7 ”动态 调试 按钮 
此 时 会 弹出 一 个 进程 选择 提示 框 ， 如 图 13.8 所 示 。 


两 Choose Process DU) 


Select a process to attach to: 


[DL] Show all processes 


Debugger: | Auto 四 


国 Emulator Nexus_5X_API 24 Androld 7 


com.example.broadcastbestpractice 


ls | Cancel | 


图 13.8 ”进程 选择 提示 框 


这 里 目前 只 列 出 了 一 个 进程 ， 也 就 是 我 们 当前 程序 的 进程 。 选 中 这 个 进 
程 ， 然 后 点 击 OK 按 钮 ， 就 会 让 这 个 进程 进入 到 调试 模式 了 。 


接 下 来 在 程序 中 点 击 Login 按 钮 ，Android Studio 同 样 也 会 自动 打开 Debug 窗 
口 ， 之 后 的 流程 就 都 是 相同 的 了 。 相 比 起 来 ， 第 二 种 调试 方式 会 比 第 一 种 
更 加 灵活 ， 也 更 加 常用 。 


13.5 ”创建 定时 任务 


Android 中 的 定时 任务 一 般 有 两 种 实现 方式 ， 一 种 是 使 用 Java API 里 提供 的 
Timer 类 ， 一 种 是 使 用 Android 的 Alarm 机 制 。 这 两 种 方式 在 多 数 情 况 下 都 能 
实现 类 似 的 效果 ， 但 Timer 有 一 个 明显 的 短 板 ， 它 并 不 太 适 用 于 那些 需要 长 
期 在 后 台 运 行 的 定时 任务 。 我 们 都 知道 ， 为 了 能 让 电池 更 加 耐用 ， 每 种 手 
机 都 会 有 目 己 的 休眠 策略 ，Android 手 机 惑 会 在 长 时 间 不 操作 的 情况 下 有 目 动 
让 CPU 进入 到 睡眠 状态 ， 这 残 有 可 能 导致 mer 中 的 定时 任务 无 法 正常 运 

行 。 而 Alarm 则 具有 唤醒 CPU 的 功能 ， 它 可 以 保证 在 大 多 数 情况 下 需要 执行 
定时 任务 的 时 候 CPU 都 能 正常 工作 。 需 要 注意 ， 这 里 唤醒 CPU 和 唤醒 屏幕 
完全 不 是 一 个 概念 ， 千 万 不 要 产生 混 消 。 


13.5.1 Alarm 机 制 


那么 首先 我 们 来 看 一 下 Alarm 机 制 的 用 法 吧 ， 其 实 并 不 复 杀 ， 主 要 残 是 借助 
了 AlarmManager 类 来 实现 的 。 这 个 类 和 NotificationManager 有 点 类 似 ， 都 
是 通过 调用 Context 的 getsystemservice() 方法 来 获取 实例 的 ， 只 是 这 里 需 

要 传 入 的 参数 是 context .ALARM_SERVICE 。 因 此 ， 获 取 一 个 ALlarmManager 的 
实例 就 可 以 写成 : 


AlarmManager manager = (AlarmManager) getSystemService(Context.ALARM_ SERVICE); 


接 下 来 调用 AlarmManager 的 set() 方法 就 可 以 设置 一 个 定时 任务 了 ， 比如 说 
想 要 设 定 一 个 任务 在 10 秒 钟 后 执行 ， 束 可 以 写成 : 


long triggerAtTime = SystemClock.elapsedRealtime() + 10 * 1000; 
manager .set(AlarmManager .ELAPSED_REALTIME WAKEUP, triggerAtTime, pendingIntent); 


上 面 的 两 行 代码 你 不 一 定 能 看 得 明白 ， 因 为 set() 方法 中 需要 传 入 的 3 个 参 
数 稍微 有 点 复杂 ， 下 面 我 们 就 来 仔细 地 分 析 一 下 。 第 一 个 参数 是 一 个 整 型 
参数 ， 用 于 指定 AlarmManager 的 工作 类 型 ， 有 4 种 值 可 选 ， 分 别 是 
ELAPSED_REALTIME 、ELAPSED_REALTIME_WAKEUP 、RTC 和 RTC_WAKEUP 。 其 中 
ELAPSED_REALTIME 表示 让 定时 任务 的 触发 时 间 从 系统 开机 开始 算 起 ， 但 不 
会 唤醒 CPU。ELAPSED_REALTIME_WAKEUP 同样 表示 让 定时 任务 的 触发 时 间 从 
系统 开机 开始 算 起 ， 但 会 唤醒 CPU 。RTc 表示 让 定时 任务 的 触发 时 间 从 1970 
年 1 月 1 日 0 点 开始 算 起 ， 但 不 会 唤醒 CPU。RTC_wAKEUP 同样 表示 让 定时 任务 
的 触发 时 间 从 1970 年 1 月 1 日 0 点 开始 算 起 ， 但 会 唤醒 CPU“。 使 用 
Systemclock.elapsedRealtime() 方法 可 以 获取 到 系统 开机 至 今 所 经 历时 间 
的 守 秒 数 ， 使 用 system.currentTimeMillis() 方法 可 以 获取 到 1970 年 1 月 1 日 
0 点 至 今 所 经 历时 间 的 毫秒 数 。 


然后 看 一 下 第 二 个 参数 ， 这 个 参数 束 好 理解 多 了 ， 就 是 定时 任务 触发 的 时 
间 ， 以 晤 秒 为 单位 。 如 果 第 一 个 参数 使 用 的 是 ELAPSED_REALTIME 或 
ELAPSED_REALTIME_WAKEUP ， 则 这 里 传 入 开机 至 今 的 时 间 再 加 上 延迟 执行 的 
时 间 。 如 果 第 一 个 参数 使 用 的 是 RTc 或 RTc_WAKEUP ， 则 这 里 传 入 1970 年 1 月 1 
日 0 点 至 今 的 时 间 再 加 上 延迟 执行 的 时 间 。 


第 三 个 参数 是 一 个 pendingIntent ， 对 于 它 你 应 该 已 经 不 会 陌生 了 吧 。 这 里 
我 们 一 般 会 调用 getservice() 方法 或 者 getBroadcast ( ) 方法 来 获取 一 个 能 


够 执行 服务 或 广播 的 PendingIntent 。 这 样 当 定时 任务 被 触发 的 时 候 ， 服 务 
的 onstartcommand( ) 方法 或 广播 接收 器 的 onReceive() 方法 不可 以 得 到 执 
行 。 

了 解 了 set() 方法 的 每 个 参数 之 后 ， 你 应 该 能 想到 ， 设 定 一 个 任务 在 10 秒 钟 
后 执行 也 可 以 写成 : 


long triggerAtTime = System.currentTimeMillis() + 10 * 1000 
manager.set(AlarmManager ,.RTC_WAKEUP，triggerAtTime，pendingIntent ) ， 


那么 ， 如 果 我 们 要 实现 一 个 长 时 间 在 后 台 定 时 运行 的 服务 该 怎么 做 呢 ? 其 
实 很 简单 ， 首先 新 建 一 个 普通 的 服务 ， 比如 把 它 起 名 叫 LongRunningservice 
， 然 后 将 触发 定时 任务 的 代码 写 到 onstartcommand() 方法 中 ， 如 下 所 示 : 


public class LongRunningService extends Service { 


QOverride 

public IBinder onBind(Intent intent) { 
return null; 

} 


Q@Override 
public int onStartCommand(Intent intent, int flags, int StartId) { 
new Thread(new Runnable() { 
Q@Override 
public void run() { 


// 在 这 里 执行 具体 的 逻辑 操作 


} 
}).start(); 
AlarmManager manager = (AlarmManager) getSystemService(ALARM_ SERVICE); 
int anHour = 60 * 60 * 1000; ”// 这 是 一 小 时 的 毫秒 类 
Jong triggerAtTime = SystemClock.elapsedRealtime() + anHour ， 
Intent i = new Intent(this, LongRunningService.class); 
PendingIntent pi = PendingIntent.getService(this, 0, i, 0); 
manager .set(AlarmManager .ELAPSED_ REALTIME_ WAKEUP, triggerAtTime, pi); 
return super.onSstartCcommand(intent, flags, startId); 


可 以 看 到 ， 我 们 先是 在 onstartcommand() 方法 中 开启 了 个 子 线程 ， 这 作 
束 可 以 在 这 里 执行 具体 的 逻辑 操作 了 。 之 所 以 要 在 子 线程 里 执行 逻辑 操 
作 ， 是 因为 逻辑 操作 也 是 需要 耗 时 的 ， 如 果 放 在 主线 程 里 执行 可 能 会 对 定 
时 任务 的 准确 性 造成 轻微 的 影响 。 


创建 线程 之 后 的 代码 丈 是 我 们 刚刚 讲解 的 Alarm 机 制 的 用 法 了 ， 移 是 获取 到 
了 AlarmManager 的 实例 ， 然 后 定义 任务 的 触发 时 间 为 一 小 时 后 ， 再 使 用 
PendingIntent 指 定 处 理 定时 任务 的 服务 为 LongRunningService， 最 后 调用 
set() 方法 完成 设 定 。 

这 样 我 们 惑 将 一 个 长 时 间 在 后 台 定 时 运行 的 服务 成 功 实现 了 。 因 为 一 旦 局 
动 了 LongRunningService， 束 会 在 onstartcommand() 方法 里 设 定 一 个 定时 任 
务 ， 这 样 一 小 时 后 将 会 再 次 启动 LongRunningService， 从 而 也 就 形成 了 一 个 
永久 的 循环 ， 保 证 LongRunningService 的 onstartcommand( ) 方法 可 以 每 隔 一 
小 时 就 执行 一 次 。 


最 后 ， 只 需要 在 你 想 要 启动 定时 服务 的 时 候 调 用 如 下 代码 即 可 : 


Intent intent = new Intent(context，LongRunningService.class ) ; 
context.startService(intent); 


男 外 需要 注意 的 是 ， 从 Android 4.4 系 统 开始 ，Alarm 任 务 的 触发 时 间 将 会 变 
得 不 准确 ， 有 可 能 会 延迟 一 段 时 间 后 任务 才能 得 到 执行 。 这 并 不 是 个 bug， 
而 是 系统 在 耗 电 性 方面 进行 的 优化 。 系 统 会 目 动 检测 目前 有 多 少 Alarm 任 务 
存在 ， 然 后 将 触发 时 间 相 近 的 几 个 任务 放 在 一 起 执行 ， 这 就 可 以 大 幅度 地 
减少 CPU 被 唤醒 的 次 数 ， 从 而 有 效 延 长 电池 的 使 用 时 间 。 


当然 ， 如 果 你 要 求 Alarm 任 务 的 执行 时 间 必 须 准 确 无 误 ，Android 仍 然 提 供 
了 解决 方案 。 使 用 AlarmManager 的 setExact() 方法 来 替代 set() 方法 ， 束 基 
本 上 可 以 保证 任务 能 够 准时 执行 了 。 


13.5.2” Doze 模式 


里 然 Android 的 每 个 系统 收 本 都 在 手机 电量 方面 努力 进行 优化 ， 不 过 一 直 没 

能 解决 后 台 服 务 泛滥、 手机 电量 消耗 过 快 的 问题 。 于 是 在 Android 6.0 系 统 
谷歌 加 入 了 一 个 全 新 的 Doze 模 式 ， 从 而 可 以 极 大 幅度 地 延长 电池 的 使 
用 寿命 ”本 小 节 中 我 们 就 来 了 解 一 下 这 人 模式， 并且 掌握 一 些 编程 时 的 注 
意 事 项 。 


首先 看 一 下 到 底 什 么 是 Doze 模 式 。 当 用 户 的 设备 是 Android 6. 人 
时 ， 如 果 该 设备 未 揪 接 电源 ， 处 于 静止 状态 (Android 7.0 中 删除 了 这 一 
件 ) ， 且 屏幕 关闭 了 一 段 时 间 之 后 ， 就 会 进入 到 Doze 模 式 。 J 


下 ， 系 统 会 对 CPU 、 网 络 、Alarm 等 活动 进行 限制 ， 从 而 延长 了 电池 的 使 用 
寿命 


HH ° 
当然 ， 系 统 并 不 会 一 直 处 于 Doze 模 式 ， 而 是 会 间歇 性 地 退出 Doze 模 式 一 小 


段 时 间 ， 在 这 段 时 间 中 ， 应 用 就 可 以 去 完成 它们 的 同步 操作 、Alarm 任 务 ， 
等 等 。 图 13.9 完 整 描 述 了 Doze 模 式 的 工作 过 程 。 
未 播 电源 短暂 退出 Doze 模 式 


设备 静止 
‖ | "| | 
, 


屏幕 关闭 

图 13.9 Doze 模式 的 工作 过 程 
可 以 看 到 ， 随 着 设备 进入 Doze 模 式 的 时 间 越 长 ， 间 区 性 地 退出 Doze 模 式 的 
时 间 间 隔 也 会 越 长 。 因 为 如 果 设 备 长 时 间 不 使 用 的 话 ， 是 没 必 要 频繁 退出 
Doze 模 式 来 执行 同步 等 操作 的 ，Android 在 这 些 细节 上 的 把 控 使 得 电池 寿命 
进一步 得 到 了 延长 。 
接 下 来 我 们 具体 看 一 看 在 Doze 模 式 下 有 哪些 功能 会 受到 限制 吧 。 

。 网 络 访问 被 禁止 。 

。 系 统 包 略 唤醒 CPU 或 者 屏幕 操作 。 

。 系统 不 再 执行 WIFI 扫描 。 

。 系统 不 再 执行 同步 服务 。 

。Alarm 任 务 将 会 在 下 次 退出 Doze 模 式 的 时 候 执 行 。 
注意 其 中 的 最 后 一 条 ， 也 就 是 说 ， 在 Doze 模 式 下 ， 我 们 的 Alarm 任 务 将 会 变 
得 不 准时 。 当 然 ， 这 在 大 多 数 情 况 下 都 是 合理 的 ， 因 为 只 有 当 用 户 长 时 间 


不 使 用 手机 的 时 候 才 会 进入 Doze 模 式 ， 通 向 在 这 种 情况 下 对 Alarm 任 务 的 准 
时 性 要 求 并 没有 那么 高 。 


寺 间 


不 过 ， 如 果 你 真 的 有 非常 特殊 的 需求 ， 要 求 Alarm 任 务 即 使 在 Doze 模 式 下 也 
必须 正常 执行 ，Android 还 是 提供 了 解决 方案 。 调 用 AlarmManager 的 
setAndAllowwWhileIdle() 或 setExactAndALLowwhileIdle() 方法 束 能 让 定时 
任务 即使 在 Doze 模 式 下 也 能 正常 执行 了 ， 这 两 个 方法 之 间 的 区 别 和 set() 、 
setExact() 方法 之 间 的 区 别 是 一 样 的 。 


13.6 ”多 窗口 模式 编程 


由 于 手机 屏幕 大 小 的 限制 ， 传 统 情况 下 一 个 手机 只 能 同时 打开 一 个 应 用 程 
序 ， 无 论 是 Android、iOS 还 是 windows Phone 都 是 如 此 。 我 们 也 早 就 对 此 习 
以 为 常 ， 认 为 这 是 理所当然 的 事情 。 而 Android 7.0 系 统 中 却 引 入 了 一 个 非常 
有 特色 的 功能 多 窗口 模式 ， 它 允许 我 们 在 同一 个 屏幕 中 同时 打开 两 个 
应 用 程序 。 对 于 手机 屏幕 越 来 越 大 的 今天 ， 这 个 功能 确实 是 越发 重要 了 ， 
那么 本 节 中 我 们 就 将 针对 这 一 主题 进行 学 习 。 


13.6.1 进入 多 窗口 模式 


首先 你 需要 知道 ， 我 们 不 用 编写 任何 额外 的 代码 来 让 应 用 程序 支持 多 窗口 
模式 。 事 实 上 ， 本 书 中 所 编写 的 所 有 项 目 都 是 文 持 多 窗口 模式 的 。 但 是 这 
并 不 意味 着 我 们 就 不 需要 对 多 窗口 模式 进行 学 习 ， 因 为 系统 化 地 了 解 这 些 
知识 后 才 能 编写 出 在 多 窗口 模式 下 兼容 性 更 好 的 程序 。 


那么 先 来 看 一 下 如 何 才能 进入 到 多 窗口 模式 。 手 机 的 导航 栏 你 肯定 是 再 熟 
悉 不 过 了 ， 上 面 一 共有 3 个 按钮 ， 如 图 13.10 所 示 。 


图 13.10 手机 导航 栏 


其 中 左边 的 Back 按 钮 和 中 间 的 Home 按 钮 我 们 都 经 常 使 用 ， 但 是 右边 的 
Overview 按 钮 使 用 得 束 比 较 少 了 。 这 个 按钮 的 作用 是 打开 一 个 最 近 访 问 过 
的 活动 或 任务 的 列表 界面 ， 2 E 够 方便 地 在 多 个 应 用 程序 之 间 进 行 切 
换 ， 如 图 13.11 所 示 。 
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图 13.11 Overview 列表 界面 
我 们 可 以 通过 以 下 两 种 方式 进入 多 窗口 模式 。 


。 在 Overview 列 表 界面 长 按 任意 一 个 活动 的 标题 ， 将 该 活动 拖 动 到 屏幕 
突出 显示 的 区 域 ， 则 可 以 进入 多 窗口 模式 。 


。 打 开 任 意 一 个 程序 ， 长 按 Overview 按 钮 ， 也 可 以 进入 多 窗口 模式 。 


比如 说 我 们 首先 打开 了 MaterialTest 程 序 ， 然 后 长 按 Overview 按 钮 ， 效 果 如 
图 13.12 所 示 。 


一 Fruits 


图 13.12 进入 多 窗口 模式 


可 以 看 到 ， 现 在 整个 屏幕 被 分 成 了 上 下 两 个 部 分 ，MaterialTest 程 序 占据 了 
上 半 屏 ， 下 半 屏 仍然 还 是 一 个 Overview 列 表 界 面 ， 另 外 Overview 按 钮 的 样式 
也 有 了 变化 。 现 在 我 们 可 以 从 Overview 列 表 中 选择 任意 一 个 其 他 程序 ， 比 
如 说 这 里 点 击 LBSTest， 效 果 如 图 13.13 所 示 。 
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图 13.13 同时 打开 两 个 程序 


我 们 还 可 以 将 模拟 恬 旋 转 至 水 平方 同 ， 这 样 上 下 分 屏 的 多 窗口 模式 会 自动 
切换 成 左右 分 屏 的 多 窗口 模式 ， 如 图 13.14 所 示 。 


三 Fruits - LBSTest 


图 13.14 左右 分 屏 的 多 窗口 模式 


多 窗口 模式 的 用 法 大 概 束 是 这 个 样子 了 ， 我 们 可 以 将 任意 两 个 应 用 同时 打 

开 ， 这 样 束 能 组 合 出 许多 更 为 丰富 的 使 用 场景 。 比 如 说 刷 微 博 的 同时 还 能 

时 刻 天 注 QQ 群 消 轧 ， 看 电影 的 同时 还 能 和 别人 一 直 聊 着 微 信 ， 等 等 。 如 末 
想 要 退出 多 窗口 模式 ， 只 需要 再 次 长 按 Overview 按 钮 ， 或 者 将 屏幕 中 央 的 

分 隔 线 向 屏幕 任意 一 个 方向 拖 动 到 底 即 可 。 


可 以 看 出 ， 在 多 窗口 模式 下 ， 整 个 应 用 的 界面 会 缩小 很 多 ， 那 么 编写 程序 
时 束 应 该 多 考虑 使 用 match_parent 属性 、RecyclerView、ListView、 
ScrollView 等 控件 ， 来 让 应 用 的 界面 能 够 更 好 地 适 配 各 种 不 同 尺 寸 的 屏幕 ， 
尽量 不 要 出 现 屏 幕 尺寸 变化 过 大 时 界面 束 无 法 正常 显示 的 情况 。 


13.6.2 多 窗口 模式 下 的 生命 周期 


接 下 来 我 们 学 习 一 下 多 窗口 模式 下 的 生命 周期 。 其实 多 窗口 模式 并 不 会 改 
变 活 动 原 有 的 生命 周期 ， 只 是 会 将 用 户 最 近 交 互 过 的 那个 活动 设置 为 运行 
状态 ， 而 将 多 窗口 模式 下 男 外 一 个 可 见 的 活动 设置 为 暂停 状态 。 如 末 这 时 
用 户 又 去 和 和 暂停 的 活动 进行 交互 ， 那 么 该 活动 驶 变 成 运行 状态 ， 之 前 处 于 
运行 状态 的 活动 变 成 暂停 状态 。 


下 面 我 们 还 是 通过 一 个 例子 来 更 加 直观 地 理解 多 窗口 模式 下 活动 的 生命 周 
期 。 首先 打开 MaterialTest 项 目 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private static final String TAG = "MaterialTest"; 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d(TAG, "onCreate"); 


} 


QOverride 

protected void onStart() { 
super .onStart() ， 
Log.d(TAG, "onStart"); 

} 


QOverride 

protected void onResume() { 
super .onResume(); 
Log.d(TAG, "onResume"); 

} 


QOverride 

protected void onPause() { 
super .onpause( ); 
Log.d(TAG, "onPause"); 

} 


QOverride 

protected void onStop() { 
super .onStop() ， 
Log.d(TAG, "onStop"); 

} 


QOverride 

protected void onDestroy() { 
super .onDestroy(); 
Log.d(TAG, "onDestroy"); 

} 


QOverride 

protected void onRestart() { 
super .onRestart(); 
Log.d(TAG, "onRestart"); 


这 里 我 们 在 Activity 的 7 个 生命 周期 回调 方法 中 分 别 打印 了 一 句 日 志 。 
汰 口 


yn 


点 击 Android Studio 导 航 栏 上 的 File Open Recent 一 LBSTest， 重 新 打开 
LBSTest 项 目 。 修 改 MainActivity 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private static final String TAG = "LBSTest",，; 


QOverride 

protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d(TAG, "onCreate"); 


QOverride 

protected void onStart() { 
super .onStart() ， 
Log.d(TAG, "onStart"); 

} 


QOverride 

protected void onResume() { 
super .onResume(); 
Log.d(TAG, "onResume"); 
mapView.onResume( ) ， 


} 


Q@Override 

protected void onPause() { 
super .onpause( ); 
Log.d(TAG, "onPause"); 
mapView.onpause(); 


} 


QOverride 

protected void onStop() { 
super .onSstop(); 
Log.d(TAG, "onStop"); 


QOverride 

protected void onDestroy() { 
super.onDestroy(); 
Log.d(TAG, "onDestroy"); 
mLocationClient.stop(); 
mapView.onDestroy(); 
baiduMap.setMyLocationEnabled(false); 
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Q@Override 

protected void onRestart() { 
super .onRestart(); 
Log.d(TAG, "onRestart"); 


这 里 同样 也 是 在 Activity 的 7 个 生命 周期 回调 方法 中 分 别 打印 了 一 名 日志。 注 
意 这 两 处 日 志 的 TAG 是 不 一 样 的 ， 方 便 我 们 进行 区 分 。 


先 将 MaterialTest 和 LBSTest 这 两 个 项 目的 最 新 代码 都 运行 到 模拟 器 
然后 启动 MaterialTest 程 序 。 这 时 观察 logcat 中 的 打印 日 志 (注意 要 将 
0 才 滤 器 选择 为 No Filters) ， 如 图 13.15 所 示 。 
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com. example. materialtest D/MaterialTest: onCreate 


com. example. materialtest D/MaterialTest: onStart 


com. example. materialtest D/MaterialTest: onResume 


图 13.15 启动 MaterialTest 时 的 打印 日 志 


可 以 看 到 ，oncreate() 、onstart() 和 onResume() 方法 会 依次 得 到 执行 ， 
个 也 是 在 我 们 意料 之 中 的 。 然 后 长 按 Overview 按 钮 ， 进 入 多 窗口 模式 ， 中 
时 的 打印 信息 如 图 13.16 所 示 。 
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com. example. materialtest D/MaterialTest: onPause 


图 13.16 进入 多 窗口 模式 时 的 打印 日 志 


你 会 发 现 ，MaterialTest 中 的 MainActivity 经 历 了 一 个 重新 创建 的 过 程 。 其 实 
个 是 正常 现象 ， 因 为 进入 多 窗口 模式 后 活动 的 大 小 发 生 了 比较 大 的 变 
化 ， 此 时 默认 是 会 重新 创建 活动 的 。 除 此 之 外 ， 像 横竖 屏 切换 也 是 会 重新 

创建 活动 的 。 进 入 多 窗口 模式 后 ，MaterialTest 变 成 了 暂停 状态 。 


接着 在 Overview 列 表 界 面 选 中 LBSTest 程 序 ， 打 印信 息 如 图 13.17 所 示 。 
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com. example. lbstest D/LBSTest: onCreate 
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com. example. lbstest D/LBSTest: onResume 


图 13.17 启动 LBSTest 时 的 打印 日 志 


可 以 看 到 ， 现 在 LBSTest 的 oncreate() 、onstart() 和 onResume() 方法 依次 
得 到 了 执行 ， 说 明 现 在 LBSTest 变 成 了 运行 状态 。 


接 下 来 我 们 可 以 随意 操作 一 下 MaterialTest 程 序 ， 然 后 观察 logcat 中 的 打印 日 
志 ， 如 图 13.18 所 示 。 
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com. example. materialtest D/MaterialTest: onResume 


图 13.18 


现在 LBSTest 的 onPause( ) 方法 得 到 了 执行 ， 而 MaterialTest 的 onResume() 方 
法 得 到 了 执行 ， 说 明 LBSTest 变 成 了 和 暂停 状态 ，MaterialTest 则 变 成 了 运行 状 
态 ， 这 和 我 们 在 本 小 下 开 头 所 分 析 的 生命 周期 行为 是 一 致 的 。 


了 解 了 多 窗口 模式 下 活动 的 生命 周期 规则 ， 那 么 我 们 在 编写 程序 的 时 候 ， 
束 可 以 将 一 些 关 键 性 的 点 考虑 进去 了 。 比 如 说 ， 在 多 窗口 模式 下 ， 用 户 仍 
然 可 以 看 到 处 于 暂停 状态 的 应 有 用， 那么 像 视频 播放 器 之 类 的 应 用 在 此 时 就 
应 该 能 继续 播放 视频 才 对 。 因 此 ， 我 们 最 好 不 要 在 活动 的 onPause() 方法 中 
去 处 理 视频 播放 句 的 暂停 逻辑 ， 而 是 应 该 在 onstop() 方法 中 去 处 理 ， 并 且 
在 onstart() 方法 恢复 视频 的 播放 。 


另外 ， 针 对 于 进入 多 窗口 模式 时 活动 会 被 重新 创建 ， 如 果 你 想 改变 这 一 默 
认 行 为 ， 可 以 在 AndroidManifest.xml 中 对 活动 进行 如 下 配置 : 


<activity 
android:name=" .MainActivity" 
android:label="Fruits" 
android:configChanges="orientation|keyboardHidden|screenSize|screenLayout"> 


</activity> 


| | 


加 入 了 这 行 配 置 之 后 ， 不 管 是 进入 多 窗口 模式 ， 还 是 横竖 屏 切换 ， 活 动 都 
不 会 被 重新 创建 ， 而 是 会 将 屏幕 发 生变 化 的 事件 通知 到 Activity 的 
onConfigurationChanged() 方法 当中 。 因 此 ， 如 果 你 想 在 屏幕 发 生变 化 的 时 
候 进 行 相应 的 逻辑 处 理 ， 那么 在 活动 中 重 写 onconfigurationchanged() 7 
即 可 。 


13.6.3 ”禁用 多 窗口 模式 


多 窗口 模式 虽然 功能 非常 强大 ， 但 是 未 必 了 驶 适用 于 所 有 的 程序 。 比 如 说 ， 
手机 游戏 殉 非 常 不 适合 在 多 窗口 模式 下 运行 ， 很 难 想象 我 们 如 何 一 边 玩 痢 
游戏 ， 一 边 又 操作 着 其 他 应 用 。 因 此 ，Android 还 是 给 我 们 提供 了 禁用 多 窗 
口 模式 的 选项 ， 如 采 你 非常 不 希望 目 己 的 应 用 能 够 在 多 窗口 模式 下 运行 ， 
那么 殉 可 以 将 这 个 功能 关闭 梭 。 


禁用 多 窗口 模式 的 方法 非常 简单 ， 只 需要 在 AndroidManifest.xml 的 
<application> 或 <activity> 标签 中 加 入 如 下 属 性 即 可 : 


android:resizeableActivity=["true" | "false"] 


其 中 ，true 表示 应 用 文 持 多 窗口 模式 ，false 表示 应 用 不 文 持 多 窗口 模式 ， 
如 果 不 配置 这 个 属性 ， 那 么 默认 值 为 true 。 


现在 我 们 将 MaterialTest 程 序 设置 为 不 支持 多 窗口 模式 ， 如 下 所 示 : 


<application 


android:resizeableActivity="false"> 


</application> 


重新 运行 程序 ， 人 然后 长 按 Overview 按 钮 ， 结 果 如 图 13.19 所 示 。 


-一 了 


图 13.19 不 支持 多 窗口 模式 时 长 按 Overview 按 钮 


可 以 看 到 ， 现 在 是 无 法 进入 到 多 窗口 模式 的 ， 而 且 屏 医 下 方 还 会 弹出 一 个 
Toast 提 示 来 告知 用 户 ， 当 前 应 用 不 支持 多 窗口 模式 。 


虽说 android: resizeableActivity 这 个 属性 的 用 法 很 徐 单 ， 但 是 它 还 存在 着 
一 个 问题 ， 束 是 这 个 属性 只 有 当 项 目的 targetSdkVersion 指 定 成 24 或 者 更 高 的 
时 候 才 会 有 用 ， 否 则 这 个 属性 是 无 效 的 。 那 么 比如 说 我 们 将 项 目的 
targetSdkVersion 指 定 成 23， 这 个 时 候 尝 试 进入 多 窗口 模式 ， 结 果 如 图 13.20 
所 示 。 


图 13.20 ”targetSdkVersion 指 定 成 23 时 长 按 Overview 按 钮 


可 以 看 到 ， 虽 说 界面 上 弹出 了 一 个 提示 ， 告 知 我 们 此 应 用 在 多 窗口 模式 下 
可 能 无 法 正常 工作 ， 但 还 是 进入 了 多 窗口 模式 。 那 这 样 我 们 就 非常 头疼 

了 ， 因 为 有 很 多 的 老 项 目 ， 它 们 的 targetSdkVersion 都 没有 指定 到 24， 岂 不 是 
这 些 老 项 目 都 无 法 禁用 多 窗口 模式 了 ? 


针对 这 种 情况 ， 还 有 一 种 解决 方案 。Android 规 定 ， 如 采 项 目 指定 的 
targetSdkVersion 低 于 24， 并 且 活 动 是 不 允许 横 坚 屏 切换 的 ， 那 么 该 应 用 也 将 
不 文 持 多 窗口 模式 。 


默认 情况 下 ， 我 们 的 应 用 都 是 可 以 随 着 手机 的 旋转 自由 地 横竖 屏 切 换 的 ， 
如 果 想 要 让 应 用 不 允许 横竖 屏 切 换 ， 那 么 就 需要 在 AndroidManifest.xml 的 
<activity> 标签 中 加 入 如 下 配置 : 


android:screenOrientation=["portrait" | "landscape"] 


其 中 ，portrait 表示 活动 只 支持 坚 屏 ，1andscape 表示 活动 只 支持 横 屏 。 当 
然 android: screenOrientation 属性 中 还 有 很 多 其 他 可 选 值 ， 不 过 最 津 用 的 
就是 portrait 和 landscape 了 。 


现在 我 们 将 MaterialTest 的 MainActivity 设 置 为 只 支持 竖 屏 ， 如 下 所 示 : 


<activity 
android:name=" .MainActivity" 
android:label="Fruits" 
android:screenOrientation="portrait"> 


</activity> 


重 狐 运行 程序 之 后 你 会 发 现 MaterialTest 现 在 不 支持 横竖 屏 切 换 了 ， 此 时 长 
按 Overview 按 钮 会 弹出 和 图 13.19 中 一 样 的 提示 ， 说 明 我 们 已 经 成 功 人 禁用 多 
窗口 模式 了 。 


13.7 Lambda 表达 式 


Java 8 中 着 实 引 入 了 一 些 非常 有 特色 的 功能 ， 如 Lambda 表 达 式 、stream 
API、 接 口 默 认 实 现 ， 等 等 。 虽 说 我 们 本 地 安装 的 JDK 束 是 Java 8 的 版 本 ， 
不 过 本 书 中 却 一 直 没 有 使 用 过 任何 Java 8 的 新 特性 。 这 主要 是 因为 我 考虑 到 
你 对 Java 8 的 新 语法 规则 可 能 并 不 熟悉 ， 如 果 直 接应 用 到 项 目 中 的 话 ， 容 易 
因此 这 里 我 就 准备 单独 使 用 一 广 的 篇 幅 来 对 Java 8 的 新 特 
性 进行 讲解 。 


虽然 刚才 已 经 提 到 了 几 个 Java 8 中 的 新 特性 ， 不 过 现在 能 够 立即 应 用 到 项 目 
当中 的 也 就 只 有 Lambda 表 达 式 而 已 ， 因 为 stream API 和 接口 默认 实现 等 特性 
都 只 支持 Android 7.0 及 以 上 的 系统 ， 我 们 显然 不 可 能 为 了 使 用 这 些 新 特性 而 
放弃 兼容 众多 低 版 本 的 Android 手 机 。 而 Lambda 表 达 式 却 最 低 兼 容 到 
Android 2.3 系 统 ， 基 本 上 可 以 算是 履 盖 所 有 的 Android 手 机 了 ， 那 么 本 方 中 
我 们 束 米 重点 学 习 一 下 Java 8 中 的 Lambda 表 达 式 。 


Lambda 表达 式 本 质 上 是 一 种 匿名 方法 ， 它 既 没 有 方法 名 ， 也 即 没 有 访问 修 
炳 符 和 返回 值 类 型 ， 使 用 它 来 编写 代码 将 会 更 加 人 简洁， 也 更 加 易 读 。 


如 果 想 要 在 Android 项 目 中 使 用 Lambda 表 达 式 或 者 Java 8 的 其 他 新 特性 ， 首 
先 我 们 需要 在 app/build.gradle 中 添加 如 下 配置 : 


android { 


defaultConfig { 


jackOptions.enabled = true 


compileOptions { 
sourceCompatibility JavaVersion.VERSION 1 8 
targetCompatibility JavaVersion.VERSION 1 8 


后 束 可 以 开始 使 用 Lambda 表 达 式 来 编写 代码 了 ， 比 如 说 传统 情况 下 开启 
一 个 子 线程 的 写法 如 下 : 


new Thread(new Runnable() { 
QOverride 
public void run() { 
// 处 理 具体 的 逻辑 


} 
}).start(); 


而 使 用 Lambda 表 达 式 则 可 以 这 样 写 


new Thread(() -> { 
// 处 理 具体 的 逻辑 
}).start(); 


是 不 是 很 神奇 ? 不 管 是 从 代码 行 数 上 还 是 缩 进 结构 上 来 看 ，Lambda 表 达 式 
的 写法 明显 要 更 加 精简 。 


那么 为 什么 我 们 可 以 使 用 这 么 神奇 的 写法 昵 ? 这 是 因为 Thread 类 的 构造 画 


数 接收 的 参数 是 一 个 Runnable 接口 ， 并 且 该 接口 中 只 有 一 个 待 实现 方法 。 
我 们 查看 一 下 Runnable 接口 的 源码 ， 如 下 所 示 : 


public interface Runnable { 


人 
* Starts executing the active part of the class' code. This method is 
* called when a thread is started that has been created with a class which 


* implements {@code Runnable}. 
从 


public void run(); 


凡是 这 种 只 有 一 个 待 实现 方法 的 接口 ， 都 可 以 使 用 Lambda 表 达 式 的 写法 。 
比如 说 ， 通 常 创建 一 个 类 似 于 上 述 接 口 的 匿名 类 实现 需要 这 样 写 : 


Runnable runnable = new Runnable() { 
QOverride 
public void run() { 
// 添加 具体 的 实现 
} 
}; 


而 有 了 Lambda 表 达 式 之 后 我 们 就 可 以 这 样 写 了 : 


Runnable runnable1l = () -> { 


// 添加 具体 的 实现 
}; 


了 解 了 Lambda 表 达 式 的 基本 写法 ， 接 下 来 我 们 笠 试 目 定义 一 个 接口 ， 然 后 
再 使 用 Lambda 表 达 式 的 方式 进行 实现 。 


痢 建 一 个 MyListener 接 口 ， 代 码 如 下 所 示 : 


public interface MyListener { 


String doSomething(String a, int b); 


MyListener 接 口中 也 只 有 一 个 得 实现 方法 ， 这 和 Runnable 接口 的 结构 是 基本 
一 致 的 。 唯 一 不 同 的 是 ， MYyListener 中 的 dosomething() 方法 是 有 参数 并 且 
有 返回 值 的 ， 那 么 我 们 就 来 看 一 看 这 种 情况 下 该 如 何 使 用 Lambda 表 达 式 进 
行 实现 。 


其 实 写 法 也 是 比较 相似 的 ， 使 用 Lambda 表 达 式 创建 MyListener 接口 的 匿名 
实现 写法 如 下 : 


MyListener listener = (String a, int b) -> { 
String result =a + b; 
return result 


二 


可 以 看 到 ，dosomething() 方法 的 参数 直接 写 在 括号 里 面 束 可 以 了 ， 而 返回 
值 则 仍然 像 往常 一 样 ， 写 在 具体 实现 的 最 后 一 行 即 可 。 


另外 ，Java 还 可 以 根据 上 下 文 目 动 推 朵 出 Lambda 表 达 式 中 的 参数 类 型 ， 
此 上 面 的 代码 也 可 以 简化 成 如 下 写法 : 


MyListener listener = (a, b) -> { 
String result =a + b; 
return result; 


}; 


Java 将 会 自动 推断 出 参数 a 是 string 类 型 ， 参 数 b 是 int 类 型 ， 从 而 使 得 我 
们 的 代码 变 得 更 加 精简 了 。 


接 下 来 举 个 具体 的 例子 ， 比 如 说 现在 有 一 个 方法 是 接收 MyListener 参数 
的 ， 如 下 所 示 : 


public void hello(MyListener listener) { 
String a = "Hello Lambda"; 
int b = 1024; 
String result = listener.doSomething(a, b); 
Log.d("TAG", result); 


我 们 在 调用 hello( ) 这 个 方法 的 时 候 就 可 以 这 样 写 


hello((a, b) -> { 
String result = a + b; 
return result; 


}); 


那么 dosomething() 方法 融会 将 a 和 b 两 个 参数 进行 相 加 ， 从 而 最 终 的 打印 


结果 就 会 是 “Hello Lambda1024”。 


现在 你 已 经 将 Lambda 表 达 式 的 写法 基本 都 掌握 了 ， 接 下 来 我 们 看 一 看 在 
Android 当 中 有 哪些 常用 的 功能 是 可 以 使 用 Lambda 表 达 式 进行 蔡 换 的 。 


其 实 只 要 是 符合 接口 中 只 有 一 个 竺 实现 方法 这 个 规则 的 功能 ， 痢 是 可 以 使 
用 Lambda 表 达 式 来 编写 的 。 除了 刚才 举例 说 明 的 开启 子 线程 之 外 ， 还 有 像 
设置 点 击 事件 之 类 的 功能 也 是 非常 适合 使 用 Lambda 表 达 式 的 。 


传统 情况 下 ， 我 们 给 一 个 按钮 设置 点 击 事件 需要 这 样 写 : 


Button button = (Button) findViewById(R.id.button); 
button.setOonClickListener(new View.OnClickListener() { 
QOverride 
public void onClick(View v) { 
// 处 理 点 击 事件 


而 使 用 Lambda 表 达 式 之 后 ， 束 可 以 将 代码 简化 成 这 个 样子 了 : 


Button button = (Button) findViewById(R.id.button); 
button.setoncClickListener((v) -> { 

// 处 理 点 击 事件 
}); 


另外 ， 当 接口 的 等 实现 方法 有 且 只 有 一 个 参数 的 时 候 ， 我 们 还 可 以 进一步 
人 简化， 将 参数 外 面 的 括号 去 挥 ， 如 下 所 示 : 


Button button = (Button) findViewById(R.id.button); 
button.setOoncClickListener(v -> { 
// 处 理 点 击 事件 


}); 


这 样 我 们 就 将 Lambda 表 达 式 的 主要 内 容 都 掌握 了 。 当 然 ， 有 些 人 可 能 并 不 
喜欢 Lambda 表 达 式 这 种 极 简 主 义 的 写法 。 不 管 你 喜欢 与 否 ，Java 8 对 于 哪 一 
种 写法 都 是 完全 文 持 的 ， 至 于 到 必要 不 要 使 用 Lambda 表 达 陈 其 实 全 换个 
人 ， 多 一 种 选择 总 归 不 是 一 件 坏 事情 。 


13.8 “总结 


整整 13 章 的 内 容 你 已 经 全 部 学 完了 ! 本 书 的 所 有 知识 点 也 到 此 结束 ， 有 是 不 
是 感 觉 有 些 激动 呢 ? 下面 就 让 我 们 来 回顾 和 总 结 一 下 这 么 久 以 来 学 过 的 所 
有 东西 吧 。 


这 13 章 的 内 容 不 算 很 多 ， 但 却 已 经 把 Android 中 绝 大 部 分 比较 重要 的 知识 点 
都 覆盖 到 了 “。 我们 从 搭建 开发 环境 开始 学 起 ， 后 面 逐 步 学 习 了 四 大 组 件 、 

UI、 雄 片 、 数 据 存 储 、 多 媒体 、 网 络 、 定 位 服务 、Material Design 等 内 容 ， 

本 章 中 又 学 习 了 如 全 局 获取 Context、 定 制 日 志 工 具 、 调 斌 程序、 多 窗口 模 
式 编 程 、Lambda 表 达 式 等 高 级 技巧 ， 相 信 你 已 经 从 一 名 初学 者 虹 变 成 一 位 
Android 开 发 好 手 了 。 


不 过 ， 虽 然 你 已 经 储备 了 足够 多 的 知识 ， 并 掌握 了 很 多 的 最 佳 实践 技巧 ， 
但 是 你 还 从 来 没有 真正 开发 过 一 个 完整 的 项 目 ， 也 许 在 将 所 有 学 到 的 知识 
混合 到 一 起 使 用 的 时 候 ， 你 会 感到 有 些 手足 无 措 。 因 此 ， 前 进 的 脚步 仍然 
不 能 停 下 ， 下 一 章 中 我 们 会 结合 前 面 章节 所 学 的 内 容 ， 一 起 开发 一 个 天 气 
预报 程序 。 锻 炼 的 机 会 可 千 万 不 能 错过 ， 赶 快 进 入 到 下 一 章 吧 。 
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我 们 将 要 在 本 章 中 编写 一 个 功能 较为 完整 的 天 气 预 报 程序 ， 学 习 了 这 么 久 
的 Android 开 发 ， 现 在 终于 到 了 考核 验收 的 时 候 了 。 那 么 第 一 步 我 们 需要 给 


这 个 软件 起 个 好 昕 的 名 字 ， 这 里 束 叫 它 酷 欧 天 气 吧 ， 英 文 名 就 叫 作 Cool 
Weather。 人 确定 了 名 字 之 后 ， 下 面 就 可 以 开始 动手 了 。 


14.1 ”功能 需求 及 技术 可 行 性 分 析 


在 开始 编码 之 前 ， 我 们 需要 移 对 程序 进行 需求 分 机 ， 想 一 想 酷 软 天 气 中 应 
该 具备 哪些 功能 。 将 这 些 功能 全 部 整理 出 来 之 后 ， 我 们 才 好 动手 去 一 一 实 
现 。 这 里 我 认为 酷 欧 天 气 中 至 少 应 该 具备 以 下 功能 : 

。 可 以 罗列 出 全 国 所 有 的 省 、 市 、 县 ; 


。 可 以 查看 全 国 任 意 城 市 的 天 气 信息 ; 


。 可 以 目 由 地 切换 城市 ， 去 查看 其 他 城市 的 天 气 ; 
。 提供 手 动 更 新 以 及 后 台 目 动 更 新 天 气 的 功能 。 


虽然 看 上 去 只 有 4 个 主要 的 功能 点 ， 但 如 果 想 要 全 部 实现 这 些 功能 却 需要 用 
到 UI、 网 络 、 数 据 存储 、 服 务 等 技术 ， 因 此 还 是 非常 考验 你 的 综合 应 用 能 
力 的 。 不 过 好 在 这 些 技术 在 前 面 的 章节 中 我 们 全 部 都 学 习 过 了 ， 只 要 你 学 
得 用 心 ， 相 信 完 成 这 些 功能 对 你 来 说 并 不 难 


分 析 完 了 需求 之 后 ， 接 下 来 就 要 进行 技术 可 行 性 分 析 了 。 首 先 需 要 考虑 的 

个 问题 束 是 ， 我 们 如 何 才能 得 到 全 国 省 市 县 的 数据 信息 ， 以 及 如 何 才 能 
获取 到 每 个 城市 的 天 气 信息 。 比 较 遗 憾 的 是 ， 现 在 网 上 免费 的 天 气 预 报 接 
口 已 经 越 来 越 少 ， 很 多 之 前 可 以 使 用 的 接口 都 慢 慢 关闭 掉 了 ， 包 括 本 书 第 1 
版 中 使 用 的 中 国 天 气 网 的 接口 。 因 此 ， 这 次 我 也 是 特意 用 心 去 找 了 一 些 更 
加 稳定 的 天 气 预 报 服务 ， 比 如 彩云 天 气 以 及 和 风 天 气 都 非常 不 错 。 这 两 个 
天 气 预报 服务 虽说 都 是 收费 的 ， 但 它们 每 天 都 提供 了 一 定 次 数 的 免费 天 气 
预报 请 求 。 其 中 彩云 天 气 的 数据 更 加 实时 和 专业 ， 可 以 将 天 气 预报 精确 到 
分 钟 级 ， 每 天 提供 1000 次 免费 请 求 ， 和 风 天 气 的 数据 相对 简单 一 些 ， 比 较 
适合 新 手 学 习 ， 每 天 提供 3000 次 免费 请 求 。 那 么 稍 单 起 见 ， 这 里 我 们 吏 使 
用 和 风 天 气 来 作为 天 气 预报 的 数据 来 源 ， 每 天 3000 次 的 免费 请 求 对 于 学 习 
而 言 已 经 是 相当 充足 了 。 


解决 了 天 气 数 据 的 问题 ， 接 下 来 还 需要 解决 全 国 省 市 县 数据 的 问题 。 同 
样 ， 现 在 网 上 也 没有 一 个 稳定 的 接口 可 以 使 用 ， 那么 为 了 方便 你 的 学 习 ， 
我 专门 染 设 了 一 台 服 务 右 用 于 提供 全 国 所 有 省 市 县 的 数据 信息 ， 从 而 帮 你 
把 道路 都 铺 平 了 。 


那么 下 面 我 们 来 看 一 下 这 些 接口 的 具体 用 法 。 比 如 要 想 罗列 出 中 国 所 有 的 
省 份 ， 只 需 访 问 如 下 地 址 : 


http://guolin.tech/api/china 


服务 句 会 返回 我 们 一 段 JISON 格 式 的 数据 ， 其 中 包含 了 中 国 所 有 的 省 份 名 称 
以 及 省 份 d， 如 下 所 示 : 


+ 


[{"id" :1, name": "北京 "》; {"id":2, "name": "上 海 "}， {"id":3, "name": "天 津 "}， {"id" :4, "name": " 重 
庆 "}， {"id":5, "name": "香港 "]， {"id" :6, name": "澳门 "}， {"id":7, "name": "台湾 "]}， 
{"id" :8, name": "黑龙 江 "); {"id" : 9, "name": 1 吉林 "}， {"id" : 10, "name": Ms {"id" :11, "name": "内 


蒙古 "}， {"id":12, "name": "河北 "}， {"id" :13, "name": "河南 "}， {"id" :14, name": "三 1 > 
{"id" :15, name": "山东 "}， {"id":16, "name": "江苏 "}， {"id":17, "name": "浙江 "}， {"id" :18, "name": " 福 


建 "}，{"id":19, "name": "江西"}, {"id":20, "name": "安徽 "}, {"id":21, "name":" 湖 北 "}， 
{"id":22,"name":" 湖 南 "}, {"id":23,"name": "广东 "}, {"id":24, "name": "广西 "}，{"id":25, "name":" 海 
南 "}, {"id":26, "name": "贵州 "}, {"id":27, "name": "云南"}，{"id":28, "name":" 四 川 "]， 
{"id":29, "name": "西藏 "}, {"id":30,"name": "陕西"}，{"id":31, "name":" 宁 夏 "}, {"id":32,"name":" 甘 


肃 "}， {"id":33, "name": "青海 "}， {"id" :34, "name": "新 疆 "}] 


可 以 看 到 ， 这 是 一 个 JSON 数 组 ， 数 组 中 的 每 一 个 元 素 都 代表 着 一 个 省 份 。 
其 中 ， 北 系 的 id 是 1， 上 海 的 id 是 2。 那 么 如 何 才 能 知道 某 个 省 内 有 哪些 城市 
呢 ? 其 实 也 很 倍 单 ， 比 如 江苏 的 id 是 16， 访 问 如 下 地 址 即 可 : 


http://guolin.tech/api/china/16 


也 就 是 说 ， 只 需要 将 省 份 :d 添 加 到 un 地 址 的 最 后 面 就 可 以 了 ， 现 在 服务 器 
返回 的 数据 如 下 : 


[{"id":113, "name":" 南 京 "}, {"id":114, "name": "无 锡 "}, {"id":115,"name": "镇江 "}，, 
{"id" :116, "namen : "苏州 下 {"id" : 117, "name" : "南通 "}， {"id" : 118, "name" : "扬州 "}， 
{"id" :119, "name": "盐城 "}， {"id" : 120, name": "徐州 "}， {"id" : 121, "name": "淮安 ' 
{"id" :122, "namen : "连云港 "}， {"id" :123, "name" : "常州 "}， {"id" : 124, "namen : "泰州 
{"id" :125, "name": "宿迁 "}] 


这 样 我们 束 得 到 江苏 省 内 所 有 城市 的 信息 了 ， 可 以 看 到 ， 现 在 退回 的 数据 
格式 和 刚才 查看 省 份 信息 时 返回 的 数据 格式 是 一 样 的 。 相 信 此 时 你 已 经 可 
以 举一反三 了 ， 比 如 说 苏州 的 id 是 116， 那 么 想 要 知道 苏州 市 下 又 有 哪些 县 
和 区 的 时 候 ， 只 需 访 问 如 下 地 址 : 


http://guolin.tech/api/china/16/116 


这 次 服务 器 返回 的 数据 如 下 : 


[{"id":937, "name": "苏州 ", "weather_id":"CN101190401"}, 
{"id":938, "name" "常熟 ", "weather_id":"CN101190402"}，, 
{"id":939, "name": "张家港 ", "weather_id":"CN101190403"}， 
{"id":940, "name":" 昆 山 ", "weather_id":"CN101190404"}, 
{"id":941, "name":" 吴 中 ", "weather_id":"CN101190405"}, 
{"id":942, "name": "吴江 ", "weather_id":"CN101190407"}, 
{"id":943, "name":" 太 仓 ", "weather_id":"CN101190408"}] 


| | 


通过 这 种 方式 ， 我 们 束 能 把 全 国 所 有 的 省 、 市 、 县 都 罗列 出 来 了 。 那 么 解 
决 了 省 市 县 数据 的 获 了 到， 我们 又 怎样 才能 碍 看 到 具体 的 天 气 信息 呢 ? 这 丈 
必须 要 用 到 每 个 地 区 对 应 的 天 气 id 了 “。 观 察 上 面 返回 的 数据 ， 你 会 发 现 每 个 
县 或 区 都 会 有 一 个 weather_id， 拿 着 这 个 id 再 去 访问 和 风 天 气 的 接口 ， 残 能 
够 获取 到 该 地 区 具体 的 天 气 信息 了 。 


下 面 我 们 来 看 一 下 和 风 天 气 的 接口 该 如 何 使 用 。 首 先 你 需要 注册 一 个 自己 

的 账号 ， 注 册 地 址 是 http://guolin.tech/api/weather/register 。 注 册 好 了 之 后 使 
用 这 个 账号 登录 ， 就 能 看 到 自己 的 API Key， 以 及 每 天 剩余 的 访问 次 数 了 ， 

如 图 14.1 所 示 。 


我 的 产品 计划 : 免费 用 户 购买 ”有效 期 : 永久 
个 人 认证 key : bc0418b57b2d4918819d3974ac1285d9 
剩余 每 天 访问 流量 : 3000 次 


图 14.1 APIKey 和 每 天 剩余 访问 次 数 


有 了 APIKey， 再 配合 刚才 的 weather_ id， 我 们 就 能 获取 到 任意 城市 的 天 气 
信息 了 。 比 如 说 苏州 的 weather_ id 是 CN101190401， 那 么 访问 如 下 接口 即 可 
查看 苏州 的 天 和 气 信息 : 


http://guolin.tech/api/weather?cityid=CN101190401&key=bc0418b57b2d4918819d3974ac1285d9 


其 中 ，cityid 部 分 填 入 的 束 是 待 查 看 城市 的 weather_ id，key 部 分 填 入 的 驶 是 
我 们 申请 到 的 API Key。 这 样 ， 服 务 器 束 会 把 苏州 详细 的 天 气 信 息 以 JSON 
格式 返回 给 我 们 了 。 不 过 ， 由 于 返回 的 数据 过 于 复杂 ， 这 里 我 做 了 一 下 精 
人 简 处 理 ， 如 下 所 示 : 


"Heweather": [ 
{ 


"status": "ok", 
"basic": {}, 


"suggestion": {}, 
"daily_forecast": [] 


返回 数据 的 格式 大 体 上 就 是 这 个 样子 了 ， 其 中 status 代表 请 求 的 状态 ，ok 
表示 成 功 。basic 中 会 包含 城市 的 一 些 基本 信息 ，aqi 中 会 包含 当前 空气 质 
量 的 情况 ，now 中 会 包含 当前 的 天 气 信息 ，suggestion 中 会 包含 一 些 天 气相 
关 的 生活 建议 ， daily_forecast 中 会 包含 未 来 儿 天 的 天 气 言 已 9 访问 
http://guolin.tech/api/weather/doc 这 个 网 址 可 以 查看 更 加 详细 的 文档 说 明 。 


数据 都 能 获取 到 了 之 后 ， 接 下 来 就 是 JSON 解 析 的 工作 了 ， 这 对 于 你 来 说 应 
该 很 轻松 了 吧 ? 


确定 了 技术 完全 可 行 之 后 ， 接 下 来 束 可 以 开始 编码 了 。 不 过 别 着 急 ， 我 们 
准备 让 酷 欧 天 气 成 为 一 个 开源 软件 ， 并 使 用 GitHub 来 进行 代码 托管 ， 因 此 
先 让 我 们 进入 到 本 书 最 后 一 次 的 Git 时 间 。 


14.2” ”Git 时间 一 一 将 代码 托管 到 GitHub 
下 


经 过 前 面 几 章 的 学 习 ， 相 信 你 已 经 可 以 非常 熟练 地 使 用 Git 了 。 本 市 依然 是 
Git 时 间 ， 这 次 我 们 将 会 把 酪 欧 天 气 的 代码 托管 到 GitHub 上 面 。 


GitHub 是 全 球 最 大 的 代码 托管 网 站 ， 主 要 是 借助 Git 来 进行 版 本 控制 的 。 任 
何 开源 软件 都 可 以 免费 地 将 代码 提交 到 GitHub 上， 以 零 成 本 的 代价 进行 代 
码 托管 。GitHub 的 官网 地 址 是 https:/github.com/。 官 网 的 首页 如 图 14.2 所 
A?° 
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图 14.2” GitHub 首页 


首先 你 需要 有 一 个 GitHub 账 号 才能 使 用 GitHub 的 代码 托管 功能 ， 点 击 Sign 
up for GitHub 按 钮 进行 注册 ， 然 后 填 入 用 户 名 、 邮 箱 和 密码 ， 如 图 14.3 所 


外 


Create your personal account 


Username 

guolindev YA 
This will be your usemame 一 you can enter your organization s username next. 
Email Address 


sinyu890807@163.com VV 


You will occasionally receive account related emails. We promise not to share your 


email with anyone. 


Password 


Use at least one lowercase letter, one numeral, and seven characters. 


By clicking on “Create an account" below, you are agreeing to the Terms 
of Service and the Privacy Policy. 


Create an account 


图 14.3 注册 账号 


点 击 Create an account 按 钮 来 创建 账户 ， 接 下 来 会 让 你 选择 个 人 计划 ， 收 费 
计划 有 创建 私人 版 本 库 的 权限 ， 而 我 们 的 酪 欧 天 气 是 开源 软件 ， 所 以 这 里 
选择 免费 计划 就 可 以 了 ， 如 图 14.4 所 示 。 


Choose your personal plan 
电 Unlimited public repositories for free. 


2 Unlimited private repositories for $7/month. (view in CNY) 
Dont worry, you can cancel or upgrade at any time. 


中 Help me set up an organization next 
Organizations are separate from personal accounts and are best suited for 
businesses who need to manage permissions for many employees. 
Learn more about organizations， 


图 14.4 选择 免费 计划 
接着 点 击 Continue 按 钮 会 进入 一 个 问卷 调查 界面 ， 如 图 14.5 所 示 。 


How would you describe your level of programming experience? 


©O 〇 Totally new to programming Somewhat experienced Very experienced 


What do you plan to use GitHub for? (check all that apply) 
可 School projects 加 Research | Design 


LL Development _ | Project Management _.」 Other (please specify) 


Which is closest to how you would describe yourself? 
© I'm a hobbyist ) TI'm a professional Im a student 


Other (please specify) 


What are you interested in? 


e.g. tutorials, android, ruby, web-development, machine-leaming, open-source 


skip this step 


图 14.5 问卷 调查 界面 


如 有 果 你 对 这 个 有 兴趣 就 填写 一 下 ， 没 兴趣 的 话 直 接点 击 最 下 方 的 skip this 
step 跳 过 残 可 以 了 。 


这 样 我 们 束 把 账号 注册 好 了 ， 会 目 动 跳 转 到 GitHub 的 个 人 主页 ， 如 图 14.6 所 
太 ° 
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Learn Git and GitHub without any codel 


Using the Hello World guide, you'l| create a repository, start a branch 
write comments, and open a pull request 


Read the guide Start a project 


14.6_GitHub 个 人 主页 


接 下 来 加 可 以 点 击 Start a project 按 钮 来 创建 一 个 版 本 库 了 “。 由 于 我 们 是 刚刚 
注册 的 账号 ， 在 创建 版 本 库 之 前 还 需要 做 一 下 邮箱 验证 ， 验 证 成 功 之 后 就 
能 开始 创建 了 。 这 里 将 版 本 库 命 名 为 coolweather， 然 后 选择 添加 一 个 
Android 项 目 类 型 的 .gitignore 文 件 ， 并 使 用 Apache License 2.0 来 作为 酷 欧 天 
气 的 开源 协议 ， 如 图 14.7 所 示 。 
Owner Repository name 
YE guolindev ~ / coolweather pd 


Great repository names are short and memorable. Need inspiration? How about glowing-octo-adventure. 


Description (optional) 


. Public 


Anyone can see this repository, You choose who can commit 


Private 
You choose who can see and commit to this repository 


四 Initialize this repository with a README 


This will let you immediately clone the repository to your computer. Skip this step if you're importing an existing repository 


Add .gitignore: Android Add a license: Apache License 2.0 ~ 


图 14.7 ”创建 版 本 库 


接着 点 击 Create repository 按 钮 ，coolweather 这 个 版 本 库 束 创建 完成 了 ， 如 图 
14.8 所 示 。 版 本 库 主 页 地 址 是 https://github.com/guolindev/coolweather 。 


1 0 1 


St guolindev Init 


BREADME.md 


coolweather 


图 14.8 版 本 库 主 页 


可 以 看 到 ，GitHub 已 经 自动 帮 我 们 创建 了 .gitignore、LICENSE 和 
README.md 这 3 个 文件 ， 其 中 编辑 README.md 文 件 中 的 内 容 可 以 修改 酷 
欧 天 和 气 版 本 库 主 页 的 描述 。 


创建 好 了 版 本 库 之 后 ， 我 们 残 需 要 创建 酷 软 天 气 这 个 项 目 了 。 在 Android 
Studio 中 新 建 一 个 Android 项 目 ， 项 目 名 叫 作 CoolWeather， 包 名 叫 作 
com.coolweather.android， 如 图 14.9 所 示 。 


New Project 


/以 Android Studio 


Configure your new project 


| Application name: | CoolWeather 


Company Domain: | example.com 


Package name: com.coolweatherandroid |Done 


口 ] Indude C++ Support 


Project location: Ei\source\chapter3\CoolWeather | = | 


图 14.9 创建 CoolWeather 项 目 


之 后 的 步骤 不 用 多 说 ， 一 直 点 击 Next 就 可 以 完成 项 目的 创建 ， 所 有 选项 都 
使 用 默认 的 就 好 。 


接 下 来 的 一 步 非常 重要 ， 我 们 需要 将 远程 版 本 库 克 隆 到 本 地 。 首 先 必 须知 
道 远程 版 本 库 的 Git 地 址 ， 点 击 Clone or download 按 钮 就 能 够 看 到 了 ， 如 图 
14.10 所 示 。 


*new file Uploadfiles Find file Clone or download ~ 


Clone with HTTPS @ Use SSH 


Use Git or checkout with SVN using the web URL， 
https://github.com/guolindev/coolweather.g 度 
Open in Desktop Download ZIP 


图 14.10 查看 版 本 库 的 Git 地 址 


点 击 右边 的 复制 按钮 可 以 将 版 本 库 的 Git 地 址 复制 到 剪贴 板 ， 酷 欧 天 气 版 本 
库 的 Git 地 址 是 https://github.com/guolindev/coolweather.git 。 


然后 打开 Git Bash 并 切换 到 CoolWeather 的 工程 目录 下 ， 如 图 14.11 所 示 。 


ministrator/AndroidSstudioProjects/CoolWeather/ 


图 14.11 在 Git Bash 中 进入 CoolWeather 工 程 目录 


接着 输入 git clone https://github.com/guolindev/coolweather.git 来 把 远程 版 本 
库 克 隆 到 本 地 ， 如 图 14.12 所 示 。 


A A 
C1 ng into “coolweather"... 


0),， pack-reused 0 


图 14.12 将 远程 版 本 库 克 隆 到 本 地 


看 到 图 中 所 给 的 文字 提示 残 表 示 殉 隆 成 功 了 ， 并 且 .gitignore、LICENSE 和 
README.md 这 3 个 文件 也 已 经 被 复制 到 了 本 地 ， 可 以 进入 到 coolweather 目 
孙 ， 并 使 用 1s -al 命令 查看 一 下 ， 如 图 14.13 所 示 。 


5 :5 itignore 
Ed 了 21 LICENSE 
iinTstrator 19712 后 ” 沪 :59 README.md 


图 14.13 查看 克隆 到 本 地 的 文件 


现在 我 们 需要 将 这 个 目 孙 中 的 所 有 文件 全 部 复制 粘贴 到 上 一 层 目 孙 中 ， 这 
样 就 能 将 整个 CoolWeather 工 程 目录 添加 到 版 本 控制 中 去 了 。 注 意 .git 是 一 个 
隐藏 目 孙 ， 在 复制 的 时 候 千 万 不 要 漏 掉 。 另 外 ， 上 一 层 目 隶 中 也 有 一 

个 .gitignore 文 件 ， 我 们 直接 将 其 覆盖 即 可 。 复 制 完 之 后 可 以 把 coolweather 目 
孙 删 除 掉 ， 最 终 CoolWeather 工 程 的 目 孙 结构 如 图 14.14 所 示 。 


.gitignore 


:48 build.gradle 
8 CoolWeather. 1m] 


8 gradle.properties 


Administr 
Administrator : 
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图 14.14 CoolWeather 工 程 的 目录 结构 


接 下 来 我 们 应 该 把 CoolWeather 项 目 中 现 有 的 文件 提交 到 GitHub 上 面 ， 这 丈 
很 简单 了 ， 先 将 所 有 文件 添加 到 版 本 控制 中 ， 如 下 所 示 : 


git add . 


然后 在 本 地 执行 提交 操作 : 


git commit -m "First commit." 


最 后 将 提交 的 内 容 同 步 到 远程 版 本 库 ， 也 就 是 GitHub 上 面 : 


git push origin master 


主意 ， 在 最 后 一 步 的 时 候 GitHub 要 求 输入 用 户 名 和 密码 来 进行 身份 校 验 ， 
ee 和 密码 就 可 以 了 ， 如 图 14.15 所 示 。 


FE 


$ git push origin master 
Co : 74, = 


图 14.15 将 提交 的 内 容 同步 到 远程 版 本 库 


这 样 融 已 经 同步 完成 了， 现在 刷新 一 下 酷 欧 天 气 版 本 库 的 主页 ， 你 会 看 到 
刚才 提交 的 那些 文件 已 经 存在 了 ， 如 图 14.16 所 示 。 


图 14.16 在 GitHub 上 查看 提交 的 内 容 


14.3 ”创建 数据 库 和 表 


从 本 和 开始 ， 我 们 束 要 真正 地 动手 编码 了 ， 为 了 要 让 项 目 能 够 有 更 好 的 结 
构 ， 这 里 需要 在 com.coolweatherandroid 包 下 再 新 建 儿 个 包 ， 如 图 14.17 所 


外 


四 java 
加 com.coolweather.android 
加 db 
加 gson 
后 service 
后 util 
Sm MainActivity 


图 14.17 项 目的 新 结构 


其 中 db 包 用 于 存放 数据 库 模 型 相关 的 代码 ，gson 包 用 于 存放 GSON 模 型 相关 
的 代码 ，service 包 用 于 存放 服务 相关 的 代码 ，util 包 用 于 存放 工具 相关 的 代 
码 。 


根据 14.1 广 进行 的 技术 可 行 性 分 析 ， 第 一 阶段 我 们 要 做 的 束 是 创建 好 数据 库 
和 表 ， 这 样 从 服务 右 获 取 到 的 数据 才能 够 存储 到 本 地 。 关 于 数据 库 和 表 的 
创建 方式 ， 我 们 早 在 第 6 章 中 就 已 经 学 过 了 。 那 么 为 了 简化 数据 库 的 操作 ， 
这 里 我 准备 使 用 LitePal 来 管理 酷 欧 天 气 的 数据 库 。 


首先 需要 将 项 目 所 需 的 各 种 依赖 库 进 行 声明 ， 编 辑 app/build.gradle 文 件 ， 在 
dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android.support:appcompat-v7:24.2.1" 
testCompile 'junit:junit:4.12"' 
compile 'org.litepal.android:core:1.4.1"' 
compile 'com.squareup.okhttp3:okhttp:3.4.1" 


compile 'com.google.code.gson:gson:2.7' 
compile 'com.github.bumptech.glide:glide:3.7.0' 


这 里 声明 的 4 个 库 我 们 之 前 都 是 使 用 过 的 ，LitePal 用 于 对 数据 库 进 行 操作 ， 
OkHttp 用 于 进行 网 络 请 求 ，GSON 用 于 解析 JSON 数 据 ，Glide 用 于 加 载 和 展 
示 图 片 。 酷 欧 天 气 将 会 对 这 几 个 库 进 行 综合 运用 ， 这 里 直接 一 次 性 将 它们 
都 添加 进来 。 


然后 我 们 来 设计 一 下 数据 库 的 表 结 构 ， 表 的 设计 当然 是 仁者 见 仁 智 者 见 
吞 ， 并 不 是 说 哪 种 设计 就 是 最 规范 最 完美 的 。 这 里 我 准备 建立 3 张 表 : 
province、city、county， 分 别 用 于 存放 省 、 市、 县 的 数据 信息 。 对 应 到 实体 
类 中 的 话 ， 束 应 该 建立 province 、City 、County 这 3 个 类 。 


那么 ， 在 db 包 下 新 建 一 个 province 类 ， 代 码 如 下 所 示 : 


public class Province extends DataSupport { 


private int id; 

private String provinceName; 
private int provinceCode; 
public int getId() 区 


return id; 
} 


public void setId(int id) { 
this.id = id; 
+ 


public String getProvinceName() { 
return provinceName; 
} 


public void setProvinceName(String provinceName) { 
this.provinceName = provinceName; 
} 


public int getProvinceCode() { 
return provinceCode; 
+ 


public void setProvinceCode(int provinceCode) { 
this.provinceCode = provinceCode; 


其 中 ，id 是 每 个 实体 类 中 都 应 该 有 的 字段 ，provinceName 记录 省 的 名 字 ， 
provincecode 记录 省 的 代号 。 另 外 ，LitePal 中 的 每 一 个 实体 类 都 是 必须 要 
继承 自 Datasupport 类 的 。 


接着 在 db 包 下 新 建 一 个 city 类 ， 代 码 如 下 所 示 : 


public class City extends DataSupport { 


private int id; 


private String cityName; 


private int cityCcode 
private int provinceId 
public int getId() { 


return id; 
} 


public void setId(int id) { 
this.id = id; 
} 


public String getCityName() { 
return cityName; 
人 


public void setCityName(String cityName) { 
this.cityName = cityName; 
} 


public int getCityCode() { 
return cityCode; 
} 


public void setCityCode(int cityCode) { 
this.cityCode = cityCode; 


public int getProvinceId() { 
return provinceId ， 
} 


public void setProvinceId(int provinceId) { 
this.provinceId = provinceId 
+ 


其 中 ， cityName 记录 市 的 名 字 ， cityCode 记录 市 的 代号， provinceId 记录 
当前 市 所 属 省 的 id 值 。 


然后 在 db 包 下 新 建 一 个 county 类 ， 代 码 如 下 所 示 : 


public class County extends DataSupport { 


private int id; 

private String countyName; 
private String weatherId; 
private int cityId; 

public int getId() 区 


return id; 
} 


public void setId(int id) { 
this.id = id; 


} 

public String getCountyName() { 
return countyName; 

} 


public void setCountyName(String countyName) { 
this.countyName = countyName; 
4 


public String getweatherId() { 
return weatherId; 
} 


public void setweatherId(String weatherId) { 
this.weatherId = weatherId ， 
} 


public int getCityId() { 
return cityId; 
} 


public void setCityId(int cityId) { 
this.cityId = CityId ， 
} 


其 中 ，countyName 记录 县 的 名 字 ，weatherId 记录 县 所 对 应 的 天 气 id， 
cityId 记录 当前 县 所 属 市 的 id 值 。 


可 以 看 到 ， 实 体 类 的 内 容 都 非常 简单 ， 就 是 声明 了 一 些 需要 的 字段 ， 并 生 
成 相应 的 getter 和 setter 方法 束 可 以 了 。 


接 下 来 需要 配置 litepal.xml 文 件 。 右 击 app/src/main 目 录 一 New 一 Directory， 
创建 一 个 assets 目 录 ， 然 后 在 assets 目 录 下 再 新 建 一 个 ]litepal.xml 文 件 ， 接 着 
编辑 litepal.xml 文 件 中 的 内 容 ， 如 下 所 示 : 


<litepal> 


<dbname value="cool weather" /> 
<version value="1" /> 


<list> 
<mapping class="com.coolweather.android.db.Province" /> 
<mapping class="com.coolweather.android.db.city" /> 
<mapping class="com.coolweather.android.db.County" /> 
</list> 


</litepal> 


这 里 我 们 将 数据 库 名 指定 成 cool_weather， 数 据 库 版 本 指定 成 1， 并 将 
Province 、City 和 county 这 3 个 实体 类 添加 到 映射 列表 当中 。 


最 后 还 需要 再 配置 一 下 LitePalApplication， 修 改 AndroidManifest.xml 中 的 代 
码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.coolweather .android"> 


<application 
android:name="org.litepal.LitePpalApplication" 
android:allowBackup="true" 
android:icon="@mipmap/ic_launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 


</manifest> 


这 样 我 们 就 将 所 有 的 配置 都 完成 了 ， 数 据 库 和 表 会 在 首次 执行 任意 数据 库 
操作 的 时 候 目 动 创建 。 


好 了 ， 第 一 阶段 的 代码 写 到 这 里 束 差 不 多 了 ， 我 们 现在 提交 一 下 。 首 先 将 
所 有 新 增 的 文件 添加 到 版 本 控制 中 : 


接 看 执行 提交 操作 : 


git commit -m "加 入 创建 数据 库 和 表 的 各 项 配置 。" 


最 后 将 提交 同步 到 GitHub 上面: 


git push origin master 


OK! 第 一 阶段 完工 ， 下 面 让 我 们 赶快 进入 到 第 二 阶段 的 开发 工作 中 吧 。 


14.4 ”遍历 全 国 省 市 县 数据 


在 第 二 阶段 中 ， 我 们 准备 把 遍历 全 国 省 市 县 的 功能 加 入 ， 这 一 阶段 需要 编 
写 的 代码 量 比较 大 ， 你 一 定 要 跟 上 脚步 。 
我 们 已 经 知道 ， 全 国 所 有 省 市 县 的 数据 部 是 从 服务 占 端 获取 到 的 ， 因 此 这 


里 和 服务 器 的 交互 是 必 不 可 少 的 ， 所 以 我 们 可 以 在 util 包 下 先 增加 一 个 
Httputil 类 ， 代 码 如 下 所 示 : 


public class HttpUtil { 


public static void sendOkHttpRequest(String address, okhttp3.Callback callback) { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder().url(address).build(); 
client.newCall(request).enqueue(callback); 


} 


由 于 OkHttp 的 出 色 封 装 ， 这 里 和 服务 器 进行 交互 的 代码 非常 简单 ， 仅 仅 3 行 
就 完成 了 。 现 在 我 们 发 起 一 条 HTTP 请 求 只 需要 调用 sendokHttpRequest () 方 
法 ， 传 入 请 求 地 址 ， 并 注册 一 个 回调 来 处 理 服务 器 响应 就 可 以 了 。 


另外 ， 由 于 服务 亏 返 回 的 省 市 县 数据 都 是 JSON 格 式 的 ， 所 以 我 们 最 好 再 提 
供 一 个 工具 类 来 解析 和 处 理 这 种 数据 。 在 util 包 下 新 建 一 个 utility 类 ， 代 
码 如 下 所 示 : 


public class Utility { 


六 过 家 


* 解析 和 处 理 服务 器 返回 的 省 级 数据 
4 
public static boolean handleProvinceResponse(String response) { 
if (!TextUtils.isEmpty(response)) { 
try { 
JSONArray allProvinces = new JSONArray(response); 
for (int i = 0; i < allProvinces.length(); i++) { 
JSONObject provinceobject = allProvinces.getJSONObject(i); 
Province province = new Province(); 
province.setProvinceName(provinceObject.getSstring("name")); 
province.setProvinceCode(provinceObject.getInt("id")); 
province. save( ); 


} 
return true; 

} catch (JSONException e) { 
e.printStackTrace(); 

} 


return false; 


} 


Wa 
* 解析 和 处 理 服 务 器 返回 的 市 级 数据 
$f 


public static boolean handleCityResponse(String response, int provinceId) { 
if (!TextUtils.isEmpty(response)) { 
try { 
JSONArray allCities = new JSONArray(response); 
for (int i = 0; i < allCities.length(); i++) { 
JSONObject cityobject = allCities.getJSONObject(i); 
City city = new City(); 
city.setCityName(cityObject.getString("name")); 
city.setCityCode(cityObject.getInt("id")); 
City.SsetProvinceId(provinceId ) ， 
city.savel(); 
} 
return true,; 
} catch (JSONException e) { 
e.printSstackTrace( ); 
} 


return false; 


} 


天 
* 解析 和 处 理 服 务 器 返回 的 县 级 数据 
*/ 
public static boolean handleCountyResponse(String response, int cityId) { 
if (!TextUtils.isEmpty(response)) { 
try { 
JSONArray allCounties = new JSONArray(response); 
for (int i = 0; i < allCounties.length(); i++) 区 
JSONObject countyObject = allCounties.getJSONObject(i); 
County county = new County(); 
county.setCountyName(countyObject.getString("name")); 
county.setweatherId(countyObject.getString("weather_id")); 
County,SetCityId(cityId ) ， 
county. save( ) ， 


return true， 

} catch (JSONException e) { 
e,printStackTrace( ); 

} 


return false; 


可 以 看 到 ， 我 们 提供 了 handleProvincesResponse() > 
handleCitiesResponse() 、 handleCountiesResponse() 这 3 个 方法 ， 分 别 用 
于 解析 和 处 理 服务 器 返回 的 省 级 、 市 级 和 县 级 数据 。 处 理 的 方式 都 是 类 似 
的 ， 先 使 用 JSONArray 和 JSONObject 将 数据 解析 出 来 ， 然 后 组 装 成 实体 类 对 


象 ， 再 调用 save( ) 方法 将 数据 存储 到 数据 库 当 中 。 由 于 这 里 的 JSON 数 据 结 
构 比 较 简 单 ， 我 们 就 不 使 用 GSON 来 进行 解析 了 。 


需要 准备 的 工具 类 束 这 么 多 ， 现 在 可 以 开始 写 界 面 了 。 由 于 志 历 全 国 省 市 
县 的 功能 我 们 在 后 面 还 会 复 用 ， 因 此 就 不 写 在 活动 里 面 了 ， 而 是 写 在 碎片 
里 面 ， 这 样 需要 复 用 的 时 候 直 接 在 布局 里 面 引用 碎片 就 可 以 了 。 


在 res/layout 目 录 中 狐 建 choose_area.xml 布 局 ， 代 码 如 下 所 示 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="#fff"> 


<RelativeLayout 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize" 
android:background="?attr/colorPrimary"> 


<TextView 
android:id="@+id/title text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_centerInParent="true" 
android:textCcolor="#fff" 
android:textSize="20sp"/> 


<Button 

android:id="@+id/back_button" 
android:layout_width="25dp" 
android:layout_height="25dp" 
android:layout_marginLeft="10dp" 
android:layout_alignParentLeft="true" 
android:layout_centerVertical="true" 
android:background="@drawable/ic_back"/> 

</RelativeLayout> 


<ListView 
android:id="@+id/list_view" 
android:layout_width="match_parent" 
android:layout_height="match_parent"/> 


</LinearLayout> 


布局 文件 中 的 内 容 并 不 复杂 ， 我 们 先是 定义 了 一 个 头 布局 来 作为 标题 栏 ， 
将 布局 高 度 设置 为 actionBar 的 高 度 ， 背 景色 设置 为 colorPrimary。 然 后 在 头 
布局 中 放置 了 一 个 TextView 用 于 显示 标题 内 容 ， 放 置 了 一 个 Button 用 于 执行 
返回 操作 ， 注 意 我 已 经 提前 准备 好 了 一 张 ic_back. png 图 片 用 于 作为 按钮 的 有 有 
景 图 。 这 里 之 所 以 要 目 己 定义 标题 栏 ， 是 因为 碎片 中 最 好 不 要 直接 使 用 
ActionBar 或 Toolbar， 不 然 在 复 用 的 时 候 可 能 会 出 现 一 些 你 不 想 看 到 的 歼 
果 o 


接 下 来 在 头 布 局 的 下 面 定 义 了 一 个 ListView， 省 市 县 的 数据 就 将 显示 在 这 
里 。 之 所 以 这 次 使 用 了 ListView， 是 因为 它 会 自动 给 每 个 子 项 之 间 添 加 一 条 
分 隔 线 ， 而 如 果 使 用 RecyclerView 想 实现 同样 的 功能 则 会 比较 麻烦 ， 这 里 我 
们 总 是 选择 最 优 的 实现 方案 。 


接 下 来 也 是 最 关键 的 一 步 ， 我 们 需要 编写 用 于 遍历 省 市 县 数据 的 肆 片 了 。 
新 建 chooseAreaFragment 继承 目 Fragment， 代码 如 下 所 示 : 


public class ChooseAreaFragment extends Fragment { 


public static final int LEVEL_ PROVINCE = 0; 
public static final int LEVEL_CITY = 1; 
public static final int LEVEL_COUNTY = 2; 
private ProgressDialog progressDialog; 
private TextView titleText; 
private Button backButton 
private ListView listView; 
private ArrayAdapter<String> adapter ， 
private List<String> dataList = new ArrayList<>(); 
[yx 

* 省 列表 


*/ 
private List<Province> provinceList ， 


j 

* 市 列表 

4 

private List<City> cityList,; 


六 
* 县 列表 
*/ 


private List<County> countyList,; 


Pek 

* 选中 的 省 份 

本 

private Province SelectedProvince 


* 选中 的 城市 


* 当前 选中 的 级 别 
六 
private int currentLevel; 


QOverride 


public View onCreateView(LayoutIinflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.layout.choose area, container, false); 
titleText = (TextView) view.findViewById(R.id.title text); 
backButton = (Button) view.findViewById(R.id.back_button); 
JistView = (ListView) view.findViewById(R.id.1ist view); 
adapter = new ArrayAdapter<>(getContext(), android.R.1layout.simple_ list 
item 1, dataList); 
JistView,.setAdapter(adapter); 
return view; 


} 


QOverride 

public void onActivityCreated(Bundle savedInstanceState) { 
super .onActivityCreated(SavedInstanceState ) ， 
listView,.setOonItemClickListener(new AdapterView.OnItemClickListener() { 


QOverride 
public void onItemClick(AdapterView<?> parent, View view, int position, 
long id) { 


if (currentLevel == LEVEL PROVINCE) { 
selectedProvince = provinceList.get(position); 
gueryCities(); 

} else if (currentLevel == LEVEL_CITY) { 
selectedCity = cityList.get(position); 
queryCounties(); 


} 
} 
}); 
backButton.setonCclickListener(new View.OnClickListener() { 
Q@Override 
public void oncClick(View v) { 
If (currentLevel == LEVEL _ COUNTY) { 
gueryCities(); 
} else if (currentLevel == LEVEL CITY) { 
gueryProvinces(); 
} 
} 
}); 
gueryProvinces(); 
} 
ed 
* 查询 全 国 所 有 的 省 ， 优 先 从 数据 库 查 询 ， 如 果 没 有 查询 到 再 去 服务 器 上 查询 
wh 


private void queryProvinces() { 

titleText.setText(" 中 国 ")， 
backButton.setVisibility(View.GONE); 
provinceList = DataSupport.findAll(Province.class); 
if (provinceList.size() > 0) { 

dataList.clear(); 

for (Province province : provinceList) { 

dataList.add(province.getProvinceName()); 
} 


adapter .notifyDataSetChanged() ， 
listView.setSelection(0); 
currentLevel = LEVEL_PROVINCE; 

} else { 
String address = "http://guolin.tech/api/china"; 
queryFromServer(address, "province"); 


} 


Pi 

* 查询 选中 省 内 所 有 的 市 ， 优 先 从 数据 库 查 询 ， 如 果 没 有 查询 到 再 去 服务 器 上 查询 
*/ 

private void queryCities() { 


titleText.setText(selectedProvince.getProvinceName( ) ) ， 
backButton.setVisibility(View.VISIBLE); 
cityList = DataSupport.where("provinceid = ?", String.valueOof(selected 
Province.getId())).find(City,class) ， 
if (cityList.size() > 0) { 
dataList.clear(); 
for (City city : cityList) { 
dataList.add(city.getcCcityName()); 
} 


adapter .notifyDataSetChanged(); 
listView.setSelection(0); 
currentLevel = LEVEL _ CITY; 


} else { 
int provinceCode = selectedProvince.getProvinceCode(); 
String address = "http://guolin.tech/api/china/" + provinceCode; 
queryFromServer(address, "city"); 
} 
J 


* 查询 选中 市 内 所 有 的 县 ， 优 先 从 数据 库 查 询 ， 如 果 没 有 查询 到 再 去 服务 器 上 查询 
二 
private void queryCounties() { 
titleText.setText(selectedCity.getCityName()); 
backButton.setVisibility(View.VISIBLE); 
countyList = DataSupport.where("cityid = ?", String.valueOof(selectedCity. 
getId())).find(County.class); 
if (countyList.size() > 0) { 
dataList.clear(); 
for (County county : countyList) { 
dataList.add(county.getCountyName( ) ) ， 
} 


adapter .notifyDataSetChanged() ， 
listView.setSelection(0); 
currentLevel = LEVEL_COUNTY; 

} else { 
int provinceCode = selectedProvince.getProvinceCode(); 
int cityCode = SelectedCity.getCityCcode( ) ， 


String address = "http://guolin.tech/api/china/" + provinceCode + "/" + 
cityCode; 
queryFromServer(address, "county"); 
} 
Vd 

* 根据 传 入 的 地 址 和 类 型 从 服务 器 上 查询 省 市 县 数据 

大 

/ 


private void queryFromServer(String address, final String type) { 
showProgressDialog(); 
HttpUtil.sendOkHttpRequest(address, new Callback() { 
@Override 
public void onResponse(Call call, Response response) throws IOException { 
String responseText = response.body().string(); 
boolean result = false; 
if ("province".equals(type)) { 
result = Utility.handleProvinceResponse(responseText); 
} else if ("city".equals(type)) { 
result = Utility.handleCityResponse(responseText, 
selectedProvince.getId()); 
} else if ("county".equals(type)) { 
result = Utility.handleCountyResponse(responseText, 
selectedcity.getId()); 


} 
If (result) { 
getActivity().runonUiThread(new Runnable() { 
QOverride 


public void run() 1{ 
closeProgressDialog(); 
if ("province".equals(type)) { 


queryProvinces(); 


} else if ("city".equals(type)) { 
queryCities(); 
} else if ("county".equals(type)) { 


queryCounties(); 


}); 


@Override 


public void onFailure(Call call, 


IOException e) { 


// 通过 runOnUiThread( ) 方 法 回 到 主线 程 处 理 逻 辑 
getActivity().runonUiThread(new Runnable() { 


@Override 


public void run() { 


closeProgressDialog(); 
Toast .makeText(getcontext(),， "加载 失败 "，Toast .LENGTH_SHORT). 


show( ); 
} 
}); 
} 
}); 
} 
PA 此 
* 显示 进度 对 话 框 
*y 


private void showProgressDialog() { 


if (progressDialog == null) { 


progressDialog = new ProgressDialog(getActivity()); 


progressDialog.setMessage(" 


正在 加 载 . . 


2 


progressDialog.setCcanceledonTouchOutside(false); 


} 


progressDialog.show(); 
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private void closeProgressDialog() { 


if (progressDialog != nul1) { 
progressDialog.dismiss(); 
} 


这 个 类 里 的 代码 虽然 非常 多 ， 可 是 逻辑 却 不 复杂 ， 我 们 来 


oncreateview() 方法 中 先是 获取 到 了 一 些 控 件 的 实例 ， 


ArrayAdapter， 并 将 它 设 置 为 ListView 的 适配器 。 接 着 在 


慢 慢 理 一 下 。 在 


然后 去 初始 化 了 


onActivitycreated() 方法 丰 * 合 ListView 和 Button 设 置 了 点 击 事件 ， 到 这 里 我 
们 的 初始 化 工作 残 算是 完成 了 。 


在 onActivityCreated() 方法 的 最 后 ， 调 用 J queryProvinces() 方法 ， 也 就 
是 从 这 里 开始 加 载 省 级 数据 有 的。queryProvinces() 方法 中 首先 会 将 头 布局 
的 标题 设置 成 中 国 ， 将 返回 按钮 隐藏 起 来 ， 因 为 省 级 列表 已 经 不 能 再 返回 
了 。 然 后 调用 LitePal 的 查询 接口 来 从 数据 库 中 读 取 省 级 数据 ， 如 采 读 取 到 
了 就 直接 将 数据 显示 到 界面 上 ， 如 采 没 有 读 取 到 就 按照 14.1 市 讲述 的 接口 组 
装 出 一 个 请 求 地 址 ， 然 后 调用 queryFromserver( ) 方法 来 从 服务 器 上 查询 数 
据 。 


queryFromServer() 方法 中 会 调用 HttpUtil 的 sendokHttpRequest() 方法 来 癌 
服务 器 发 送 请 求 ， 啊 应 的 数据 会 回调 到 onResponse() 方法 中 ， 然 后 我 们 在 
这 里 去 调用 Utility 的 handleProvincesResponse() 方法 来 解析 和 处 理 服务 器 返 
回 的 数据 ， 并 存储 到 数据 库 中 。 接 下 来 的 一 步 很 关键 ， 在 解 林 和 处 理 完 数 
据 之 后 ， 我 们 再 次 调用 了 queryProvinces() 方法 来 重新 加 载 省 级 数据 ， 由 
于 queryProvinces() 方法 牵扯 到 了 UI 操 作 ， 因 此 必须 要 在 主线 程 中 调用 ， 
这 里 借助 了 runonuiThread() 方法 来 实现 从 子 线程 切换 到 主线 程 。 现 在 数据 
库 中 已 经 存在 了 数据 ， 因此 调用 queryProvinces() 束 会 直接 将 数据 显示 到 
界面 上 了 。 


当 你 点 击 了 某 个 省 的 时 候 会 进入 到 ListView 的 onItemclick() 方法 中 ， 这 个 
时 候 会 根据 当前 的 级 别 来 判断 是 去 调用 querycities() 方法 还 是 
queryCounties() 方法 ， queryCities() 方法 是 去 查 询 市 级 数据 ， 而 
queryCounties() 方法 是 去 查询 县 级 数据 ， 这 两 个 方法 内 部 的 流程 和 
queryProvinces() 方法 基本 相同 ， 这 里 就 不 重复 讲解 了 。 


另外 还 有 一 点 需要 注意 ， 在 返回 按钮 的 点 击 事件 里 ， 会 对 当前 ListView 的 列 
表 级 别 进 行 判断 。 如 果 当 前 是 县 级 列表 那么 殊 返 回 到 市 级 列表 ， 如 采 当 
前 是 市 级 列表 ， 那 么 吏 返 回 到 省 级 表 列 表 。 当 返回 到 省 级 列表 时 ， 返 回 按 
钮 会 自动 隐藏 ， 从 而 也 就 不 需要 再 做 进一步 的 处 理 了 。 


这 样 我 们 就 把 遍历 全 国 省 市 县 的 功能 完成 了 ， 可 是 碎片 是 不 能 直接 显示 在 
界面 上 的 ， 因 此 我 们 还 需要 把 它 添加 到 活动 里 才 行 。 修 改 activity_main.xml 
中 的 代码 ， 如 下 所 示 : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<fragment 
android:id="@+id/choose_area_ fragment" 
android:name="com.coolweather .android.ChooseAreaFragment" 
android:layout_width="match_parent" 
android:layout_height="match_parent" /> 


</FrameLayout> 


布局 文件 很 简单 ， 只 是 定义 了 一 个 FrameLayout， 人 然后 将 
ChooseAreaFragment 添 加 进来 ， 并 让 它 充 满 整个 布局 。 


另外 ， 我 们 刚才 在 雄 片 的 布局 里 面 已 经 自 定 义 了 一 个 标题 栏 ， 因 此 就 不 再 
需要 原生 的 ActionBar 了 ， 修 改 res/values/styles.xml 中 的 代码 ， 如 下 所 示 : 


<resources> 


<!-- Base application theme. --> 
<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar"> 


</style> 


</resources> 


现在 第 二 阶段 的 开发 工作 也 完成 得 差不多 了 ， 我 们 可 以 运行 一 下 来 看 看 效 
果 。 不 过 在 运行 之 前 还 有 一 件 事 没 有 做 ， 那 就 是 声明 程序 所 需要 的 权限 。 
修改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.coolweather .android"> 


<uses-permission android:name="android.permission.INTERNET" /> 


</manifest> 


由 于 我 们 是 通过 网 络 接 口 来 获取 全 国 省 市 县 数据 的 ， 因 此 必须 要 添加 访问 
网 络 的 权限 才 行 。 


现在 可 以 运行 一 下 程序 了 ， 结 果 如 图 14.18 所 示 。 


图 14.18 ”显示 省 级 数据 


可 以 看 到 ， 人 全国 所 有 省 级 数据 都 显示 出 来 了 。 我 们 还 可 以 继续 查看 市 级 数 
据 ， 比 如 点 击 江苏 省 ， 结 有 末 如 图 14.19 所 示 。 


2 总 2:43 


图 14.19 显示 市 级 数据 
这 个 时 候 标 题 栏 上 会 出 现 一 个 返回 按钮 ， 用 于 返回 上 一 级 列表 。 
然后 再 点 击 苏州 市 查看 县 级 数据 ， 结 果 如 图 14.20 所 示 。 


图 14.20 显示 县 级 数据 
好 了 ， 这 样 第 二 阶段 的 开发 工作 也 都 完成 了 ， 我 们 仍然 要 把 代码 提交 一 
下 。 


git add . 
git commit -m "完成 遍历 省 市 县 三 级 列表 的 功能 。" 
git push origin master 


到 目前 为 止 进度 算是 相当 不 错 啊 ， 那 么 我 们 就 趁 热 打铁 ， 来 进行 第 三 阶段 
的 开发 工作 。 


14.5 ”显示 天 气 信息 


在 第 三 阶段 中 ， 我 们 就 要 开始 去 查询 天 气 ， 并 且 把 天 气 信 息 显 示 出 来 了 。 
由 于 和 风 天 气 返回 的 JSON 数 据 结构 非常 复杂 ， 如 果 还 使 用 JSONObject 来 解 
析 就 会 很 及 烦 ， 这 里 我 们 就 准备 借助 GSON 来 对 天 气 信 息 进 行 解析 了 。 


14.5.1 定义 GSON 实 体 类 

GSON 的 用 法 很 简单 ， 解 析 数 据 只 需要 一 行 代码 就 能 完成 了 ， 但 前 提 是 要 先 
将 数据 对 应 的 实体 类 创建 好 。 由 于 和 风 天 气 返 回 的 数据 内 容 非 常 多 ， 这 里 
我 们 不 可 能 将 所 有 的 内 容 都 利用 起 来 ， 因 此 我 筛选 了 一 些 比较 重要 的 数据 
来 进行 解析 。 

首先 我 们 回顾 一 下 返回 数据 的 大 致 格式 : 


"Heweather": [ 
{ 


"suggestion": {}, 
"daily_forecast": [] 


其 中 ， basic ~、aqi 、now 、suggestion 和 daily_forecast 的 内 部 又 都 会 有 
具体 的 内 容 ， 那 么 我 们 就 可 以 将 这 5 个 部 分 定义 成 5 个 实体 类 。 


下 面 开始 来 一 个 个 看 ，basic 中 具体 内 容 如 下 所 示 : 


"basic":{ 
"city" : "苏州 ""， 
"id":"CN101190401", 
"update":{ 
"Joc":"2016-08-08 21:58" 


} 
} 


其 中 ，city 表示 城市 名 ，id 表示 城市 对 应 的 天 气 id，update 中 的 loc 表示 
天 气 的 更 狐 时 间 。 我 们 按照 此 结构 吏 可 以 在 gson 包 下 建立 一 个 Basic 类 ， 代 
码 如 下 所 示 : 


public class Basic { 


Q@SerializedName("city") 
public String cityName; 


Q@SerializedName("id") 
public String weatherId; 


public Update update; 
public class Update { 


@SerializedName("loc") 
public String updateTime; 


由 于 JSON 中 的 一 些 字段 可 能 不 太 适 合 直接 作为 Java 字 段 来 命名 ， 因 此 这 里 

使 用 了 @SerializedName 注 解 的 方式 来 让 JSON 字 段 和 Java 字 段 之 间 建 立 映 射 

关系 。 

这 样 我 们 就 将 Basic 类 定义 好 了 ， 还 是 挺 容易 理解 的 吧 ? 其 余 的 几 个 实体 类 
和 我 们 使 用 同样 的 方式 来 定义 就 可 以 了 。 比 如 aqi 中 的 具体 内 容 
0 下 如 示 : 


那么 ， 在 gson 包 下 新 建 一 个 AQI 类 ， 代 码 如 下 所 示 : 


public class AQI { 


public AQICity city; 
public class AQICity { 
public String aqi,; 


public String pm25; 


now 中 的 具体 内 容 如 下 所 示 : 


"now":{ 
"tmp" : "29", 
"cond":{ 
ntxt": "阵雨 


} 


那么 ， 在 gson 包 下 新 建 一 个 Now 类 ， 代 码 如 下 所 示 : 


public class Now { 


Q@sSerializedName("tmp") 
public String temperature; 


Q@SerializedName("cond") 
public More more; 


public class More { 


@SerializedName("txt") 
public String info; 


"suggestion":{ 
"comf":{ 
"txt": "白天 天 气 较 热 ， 虽 然 有 两 ， 但 仍然 无 法 削弱 较 高 气温 给 人 们 带 来 包 
这 种 天 气 会 让 您 感到 不 很 舒适 。" 


"txt"; "不宜 尝 车， 未 来 24 小 时 内 有 R 千 此 期 间 洗车 ， 雨 水 和 路 上 的 泥水 
可 能 会 再 次 弄 脏 您 的 爱 车 。" 


}, 
"sport":{ 
"txt":" 有 降水 ， 且 风力 较 强 ， 推 荐 您 在 进行 低 强度 运动 ; 若 坚 持 户 外 运动 ， 
请 选择 避 雨 防风 的 地 点 。" 


那么 ， 在 gson 包 下 渐 建 一 个 Suggestion 类， 代码 如 下 所 示 : 


public class Suggestion { 


@SerializedName("comf") 
public Comfort comfort 


Q@SerializedName("cw") 
public Carwash carwash,; 


public Sport sport; 
public class Comfort { 


@SerializedName("txt") 
public String info; 


} 
public class Carwash { 


@SerializedName("txt") 
public String info; 


} 
public class Sport { 


@SerializedName("txt") 
public String info; 


到 目前 为 止 都 还 比较 简单 ， 不 过 接 下 来 的 一 项 数据 束 有 点 特殊 了 ， 
daily_forecast 中 的 具体 内 容 如 下 所 示 : 


"daily_forecast":[ 


€ 


"date":"2016-08-08", 


"txXxt_d" :7 阵雨" 


}, 
ntmpo": 
Dine, 
"min":"27" 


"date":"2016-08-09", 
"cond":{ 
"txt d": "多 云 " 
}, 
ntmo": 
De 
"nmin" "29" 


可 以 看 到 ， daily_forecast 中 包含 的 是 一 个 数组 ， 数 组 中 的 每 一 项 都 代表 
着 未 来 一 天 的 天 气 信息 。 针 对 于 这 种 情况 ， 我 们 只 需要 定义 出 单 日 天 气 的 
实体 类 就 可 以 了 ， 然 后 在 声明 实体 类 引用 的 时 候 使 用 集合 类 型 来 进行 声 
明 。 


那么 在 gson 包 下 新 建 一 个 Forecast 类 ， 代 码 如 下 所 示 : 


public class Forecast { 
public String date; 


Q@sSerializedName("tmp") 
public Temperature temperature; 


Q@SerializedName("cond") 
public More more; 


public class Temperature { 
public String max; 
public String min; 

} 

public class More { 


@SerializedName("txt_d") 
public String info; 


这 样 我 们 束 把 basic 、aqi 、now 、suggestion 和 daily_forecast 对 应 的 实 
体 类 全 部 都 创建 好 了 ， 接 下 来 还 需要 再 创建 一 个 总 的 实例 类 来 引用 刚刚 创 
建 的 各 个 实体 类 。 在 gson 包 下 新 建 一 个 weather 类 ， 代 码 如 下 所 示 : 


public class Weather { 


public String Status 
public Basic basic; 


public AQI aqi; 


public Now now 
public Suggestion suggestion,; 


@SerializedName("daily_forecast") 
public List<Forecast> forecastList,; 


在 weather 类 中 ， 我 们 对 Basic 、AQI 、Now 、Suggestion 和 Forecast 类 进行 


了 引用 。 其 中 ， 由 于 daily_forecast 中 包含 的 是 一 个 数组 ， 因此 这 里 使 用 


了 List 集 合 来 引用 Forecast 类 。 另 外 ， 返 回 的 天 气 数据 中 还 会 包含 一 项 
status 数 据 ， 成 功 返 回 ok， 失 败 则 会 返回 具体 的 原因 ， 那 么 这 里 也 需要 添加 
一 个 对 应 的 status 字段 。 


现在 所 有 的 GSON 实 体 类 都 定义 好 了 ， 接 下 来 我 们 开始 编写 天 气 界面 。 
14.5.2 ”编写 天 气 界面 


首先 创建 一 个 用 于 显示 天 气 信息 的 活动 。 右 击 com.coolweatherandroid 包 
New 一 Activity 一 Empty Activity， 创 建 一 个 WeatherActivity， 并 将 布局 名 
指 定 成 activity_weather.xml ° 


由 于 所 有 的 天 气 信息 都 将 在 同一 个 界面 上 显示 ， 因 此 activity_weather.xml 会 
是 一 个 很 长 的 布局 文件 。 那 么 为 了 让 里 面 的 代码 不 至 于 混乱 不 堪 ， 这 里 我 
准备 使 用 3.4.1 小 和 学 过 的 引入 布局 技术 ， 即 将 界面 的 不 同 部 分 写 在 不 同 的 
布局 文件 里 面 ， 再 通过 引入 布局 的 方式 集成 到 activity_weather.xml 中 ， 这 样 
整个 布局 文件 就 会 显得 非常 工整 。 


右 击 res/layout 一 New 一 Layout resource file， 新 建 一 个 title.xml 作 为 头 布局 ， 
代码 如 下 所 示 : 


<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize"> 


<TextView 
android:id="@+id/title_city" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_centerInpParent="true" 
android:textColor="#fff" 
android:textSize="20sp" /> 


<TextView 


android:id="@+id/title _ update time" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_marginRight="10dp" 
android:layout_alignParentRight="true" 
android:layout_centerVertical="true" 
android:textColor="#fff" 
android:textSize="16sp"/> 


</RelativeLayout> 


这 上段 代码 还 是 比较 简单 的 ， 头 布局 中 放置 了 两 个 TextView， 一 个 居中 显示 城 
市 名 ， 一 个 拓 右 显示 更 狐 时 间 。 


然后 新 建 一 个 now.xml 作 为 当前 天 气 信息 的 布局 ， 代 码 如 下 所 示 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_margin="15dp"> 


<TextView 
android:id="@+id/degree_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="end" 
android:textColor="#fff" 
android:textSize="60sp" /> 


<TextView 
android:id="@+id/weather_info_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="end" 
android:textCcolor="#fff" 
android:textSize="20sp" /> 


</LinearLayout> 


前 天 气 信 息 的 布局 中 也 是 放置 了 两 个 TextView， 一 个 用 于 显示 当前 气温 ， 
是 于 显示 天 气概 况 。 


然后 新 建 forecast.xzml 作 为 未 来 儿 天 天 气 信息 的 布局 ， 代 码 如 下 所 示 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_margin="15dp" 


android:background="#8000"> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_marginLeft="15dp" 
android:layout_marginTop="1i5dp" 
android:text=" 预 报 " 
android:textCcolor="#fff" 
android:textSize="20sp"/> 


<LinearLayout 
android:id="@+id/forecast_layout" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 
</LinearLayout> 


</LinearLayout> 


这 里 最 外 层 使 用 LinearLayout 定 义 了 一 个 半 透 明 的 背景 ， 然 后 使 用 TextView 


定义 了 一 个 标题 ， 接 着 又 使 用 一 个 LinearLayout 定 义 了 a 显示 未 来 儿 
天 天 气 尖 息 的 布局 。 不 过 这 个 布局 中 并 没有 放 入 任何 内 容 ， 因 为 这 是 要 根 
据 服务 器 返回 的 数据 在 代码 中 动态 添加 的 。 


为 此 ， 我 们 还 需要 再 定义 一 个 未 来 天 气 信息 的 子 项 布局 ， 创 建 
forecast_ item.xml 文 件 ， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_margin="15dp"> 


<TextView 
android:id="@+id/date_text" 
android:layout_width="QOdp" 
android:layout_height="wrap_content" 
android:layout_gravity="center_vertical" 
android:layout_ weight="2" 
android:textColor="#fff"/> 


<TextView 
android:id="@+id/info_text" 
android:layout_width="0Odp" 
android:layout_height="wrap_content" 
android:layout_gravity="center_vertical" 
android:layout_ weight="1" 
android:gravity="center" 
android:textColor="#fff"/> 


<TextView 
android:id="@+id/max_text" 
android:layout_width="0Odp" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:layout_ weight="1" 
android:gravity="right" 


android:textColor="#fff"/> 


<TextView 
android:id="@+id/min_text" 
android:layout_width="QOdp" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:layout_weight="1" 
android:gravity="right" 
android:textColor="#fff"/> 


</LinearLayout> 


子 项 布局 中 放置 了 4 个 TextView， 一 个 用 于 显示 天 气 预报 日 期 ， 一 个 用 于 


匡 [ 


示 天 气概 况 ， 另 外 两 个 分 别 用 于 显示 当天 的 最 高 温度 和 最 低温 度 。 
然后 新 建 aqi.xml 作 为 空气 质量 信息 的 布局 ， 代 码 如 下 所 示 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_margin="15dp" 
android:background="#8000"> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_marginLeft="15dp" 
android:layout_marginTop="1i5dp" 
android:text=" 空 气质 量 " 
android:textColor="#fff" 
android:textSize="20sp"/> 


<LinearLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_margin="15dp"> 


<RelativeLayout 
android:layout_width="QOdp" 
android:layout_height="match_parent" 
android:layout_ weight="1"> 


<LinearLayout 
android:orientation="vertical" 
android:layout_ width="match_parent" 
android:layout_height="wrap_content" 
android:layout_centerInParent="true"> 


<TextView 
android:id="@+id/aqi_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_gravity="center" 
android:textColor="#fff" 
android:textSize="40sp" 
/> 


<TextView 
android 
android 
android 
android 
android 


</LinearLayout> 
</RelativeLayout> 


<RelativeLayout 


:layout_width="wrap_content" 
:layout_height="wrap_content" 
:layout_gravity="center" 
:text="AQI 指 数 " 
:textColor="#fff"/> 


android:layout_width="QOdp" 
android:layout_height="match_parent" 
android:layout_weight="1"> 


<LinearLayout 


android:orientation="vertical" 
android:layout_ width="match_parent" 
android:layout_height="wrap_content" 
android:layout_centerInParent="true"> 


<TextView 
android 


android: 
android: 
android: 
android: 
android: 


/> 


<TextView 


android: 
android: 


android 


android: 
android: 


/> 
</LinearLayout> 
</RelativeLayout> 
</LinearLayout> 


</LinearLayout> 


:id="@+id/pm25_text" 
layout_width="wrap_content" 
layout_height="wrap_content" 
layout_gravity="center" 
textColor="#fff" 
textSize="40sp" 


layout_width="wrap_content" 
layout_height="wrap_content" 
:layout_gravity="center" 
text="PM2 .5 指数 " 
textColor="#fff" 


这 个 布局 中 的 代码 虽然 看 上 去 有 点 长 ， 但 是 并 不 复杂 。 首 先前 面 都 是 一 样 


的 ， 使 用 LinearLayout 定 义 了 一 个 半 透 明 的 


也 后 于 


背景 ， 然 后 使 用 TextView 定 义 了 


一 个 标题 。 接 下 来 ， 这 里 使 用 LinearLayout 和 RelativeLayout 骸 和 套 的 方式 实现 


ee 


中 对 齐 的 布局 ， 分 别 用 于 显示 AQI 指 数 和 PM 2.5 指 


数 。 相 信 你 只 要 仔细 看 


看， 这 个 布局 还 十 很 好 理解 的 。 


然后 新 建 suggestion.xml 作 为 生活 建议 信息 的 布局 ， 代 码 如 下 所 示 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:layout_margin="15dp" 
android:background="#8000"> 


<TextView 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_marginLeft="15dp" 
android:layout_marginTop="1i5dp" 
android:text=" 生 活 建议 " 
android:textColor="#fff" 
android:textSize="20sp"/> 


<TextView 
android:id="@+id/comfort_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_margin="15dp" 
android:textCcolor="#fff" /> 


<TextView 
android:id="@+id/car_wash_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_margin="15dp" 
android:textCcolor="#fff" /> 


<TextView 
android:id="@+id/sport_text" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
android:layout_margin="15dp" 
android:textCcolor="#fff" /> 


</LinearLayout> 


这 里 同样 也 古 先 定义 了 一 个 半 透 明 的 育 景 和 一 个 标题 ， 然 后 下 面 使 用 了 3 个 
TextView 分 别 用 于 显示 舒适 度 、 洗 车 指数 和 运动 建议 的 相关 数据 。 


这 样 我 们 就 把 天 气 界面 上 每 个 部 分 的 布局 文件 都 编写 好 了 ， 接 下 来 的 工作 
就 是 将 它们 引入 到 activity_weather.xml 当 中 ， 如 下 所 示 : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="@color/colorPrimary"> 


<ScrollView 
android:id="@+id/weather_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:scrollbars="none" 
android:overScrollMode="never"> 


<LinearLayout 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content"> 
<include layout="@layout/title" /> 
<include layout="@layout/now" /> 
<include layout="@layout/forecast" /> 
<include layout="@layout/aqi" /> 
<include layout="@layout/suggestion" /> 

</LinearLayout> 


</ScrollView> 


</FrameLayout> 


可 以 看 到 ， 首 先 最 外 层 布 局 使 用 了 一 个 FrameLayout， 并 将 它 的 背景 色 设 置 
成 colorPrimary。 然 后 在 ed 这 是 因为 天 
气 界面 中 的 内 容 比 较 多 ， 使 用 ScrollView 可 以 允许 我 们 通过 滚动 的 方式 查看 


屏幕 以 外 的 内 容 。 


由 于 ScrollView 的 内 部 只 允许 存在 一 个 直接 子 布 局 ， 因 此 这 里 又 舱 套 了 一 个 
垂直 方 回 的 LinearLayout， 然 后 在 LinearLayout 中 将 刚才 定义 的 所 有 布局 逐个 
9 


这 样 我们 吏 将 天 气 界面 编写 完成 了 ， 接 下 来 开始 编写 业务 逻辑 ， 将 天 人 气 
示 到 界面 上 。 


14.5.3 ”将 天 气 显示 到 界面 上 


首先 需要 在 utility 类 中 添加 一 个 用 于 解析 天 气 JSON 数 据 的 方法 ， 如 下 所 
A 


印 


public class Utility { 


* 将 返回 的 JSON 数 据 解析 成 Weather 实 体 类 


public static Weather handleweatherResponse(String response) { 
try { 
JSONObject jsonobject = new JSONObject(response); 
JSONArray jsonArray = jsonObject.getJSONArray("HeWweather"); 


String weatherContent = jSsonArray.getJSONObject(0).toString() ， 
return new Gson() .fromJson(weatherContent，Weather .class) 

} catch (Exception e) { 
e,printStackTrace( ); 


} 


return null; 


可 以 看 到 ， handleweatherResponse() 方法 中 先是 通过 JsoNobject 和 
JSONArray 将 天 气 数据 中 的 主体 内 容 解析 出 来 ， 即 如 下 内 容 : 


"status": "ok", 
"basic": {}, 

"aqi": {}, 

"now": {}, 
"suggestion": {}, 
"daily_forecast": [] 


需要 通 ， 方法 就 能 人 


接 下 来 的 工作 是 我 们 如 何在 活动 中 去 请 求 天 气 数据 ， 以 及 将 数据 展示 到 界 
面 上 。 修 改 WeatherActivity 中 的 代码 ， 如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 


private ScrollView weatherLayout; 
private TextView titleCity; 

private TextView titleUpdateTime; 
private TextView degreeText 

private TextView weatherInfoText ， 
private LinearLayout forecastLayout 
private TextView aqiText; 

private TextView pm25Text ， 

private TextView comfortText,; 


private TextView carwashText,; 


private TextView SportText ， 


Q@override 
protected void onCreate(Bundle SavedInstanceState) { 
Super ,onCreate(SavedInstanceState ) ; 
setCcontentView(R.1layout.activity weather); 
// 初始 化 各 控件 
weatherLayout = (ScrollView) findViewById(R.id.weather_layout); 
titleCity = (TextView) findViewById(R.id.title city); 
titleUpdateTime = (TextView) findViewById(R.id.title update time); 
degreeText = (TextView) findViewById(R.id.degree text); 
weatherInfoText = (TextView) findViewById(R.id.weather_info_text); 
forecastLayout = (LinearLayout) findViewById(R.id.forecast_ layout); 
aqiText = (TextView) findViewById(R.id.aqi text); 
pm25Text = (TextView) findViewById(R.id.pm25_text); 
comfortText = (TextView) findViewById(R.id.comfort_ text); 
carwashText = (TextView) findViewById(R.id.car_wash text); 
SportText = (TextView) findViewById(R.id.sport_ text); 
SharedPreferences prefs = PreferenceManager ,getDefau1ltSharedPreferences 
(this); 
String weatherString = prefs.getString("weather", null]l); 
If (weatherString != null) { 
// 有 缓存 时 直接 解析 天 气 数据 
Weather weather = Utility,.handleweatherResponse(weatherString ) ， 
ShowweatherInfo(weather ); 
} else { 
// 无 缓存 时 去 服务 器 查询 天 气 
String weatherId = getIntent().getSstringExtra("weather_id"); 
weatherLayout.setVisibility(View.INVISIBLE); 
requestweather (weatherId); 


} 


人 
* 根据 天 气 id 请 求 城市 天 气 信息 
大 
/ 
public void reduestweather(final String weatherId) { 


String weatherUrl = "http://guolin.tech/api/weather?cityid=" + 
weatherId + "&key=bc0418b57b2d4918819d3974ac1285d9"，; 
HttpUtil.sendOkHttpRequest(weatherUrl, new Callback() { 
Q@Override 
public void onResponse(Call call, Response response) throws IOException { 
final String responseText = response.body().string(); 
final Weather weather = Utility.handleweatherResponse(responseText); 
runonUiThread(new Runnable() { 
@Override 
public void run() { 

If (weather != null && "ok".equals(weather.status)) { 
SharedPreferences.Editor editor = PreferenceManager. 
getDefaultSharedPreferences(WeatherActivity.this). 

edit(); 
editor.putString("weather", responseText); 
editor.apply(); 
ShowweatherInfo(weather ); 

} else { 

Toast .makeText (WeatherActivity.this, "获取 天 气 信息 失败 "， 
Toast .LENGTH_SHORT) .show( ); 


}); 
} 


QOverride 
public void onFailure(Call call, IOException e) { 
e.printStackTrace(); 


runonUiThread(new Runnable() { 
Q@Override 
public void run() { 
Toast .makeText (WeatherActivity.this, "获取 天 气 信息 失败 "， 
Toast .LENGTH_SHORT) .show( ); 


} 
}); 
} 
}); 

} 

2 

* 处 理 并 展示 Weather 实 体 类 中 的 数据 
*/ 


private void ShowweatherInfo(wWeather weather) 区 

String cityName = weather .basic.cityName 

String updateTime = weather.basic.update.updateTime.split(" ")[1]; 

String degree = weather .now.temperature + "°C"; 

String weatherInfo = weather .now.more.info,; 

titleCity.setText(cityName); 

titleUpdateTime.setText(updateTime); 

degreeText.setText(degree); 

weatherInfoText.setText (weatherInfo); 

forecastLayout.removeAllViews(); 

for (Forecast forecast : weather.forecastList) { 
View view = LayoutInflater.from(this).inflate(R.layout.forecast_ 

item, forecastLayout, false); 

TextView dateText = (TextView) view.findViewById(R.id,.date text); 
TextView infoText = (TextView) view.findViewById(R.id.info_ text); 
TextView maxText = (TextView) view.findViewById(R.id.max_text); 
TextView minText = (TextView) view.findViewById(R.id.min text); 
dateText.setText(forecast.date); 
infoText.setText(forecast.more.info); 
maxText.setText(forecast.temperature.max); 
minText.setText(forecast.temperature.min); 
forecastLayout.addView(view); 


If (weather.aqi != null) { 
aqiText.setText(weather.aqi.city.aqi); 
pm25Text.setText (weather .aqi.city .pm25); 


} 

String comfort = "舒适 度 : " + weather .suggestion.comfort .info， 
String carwash = "洗车 指数 : " + weather .suggestion.carwash.info， 
String sport = "运动 建议 : " + weather .suggestion.sport.info， 


ComfortText ,SetText(comfort ) ; 
carwashText.setText(carwash); 
sportText.setText(sport); 
weatherLayout.setVisibility(View.VISIBLE); 


这 个 活动 中 的 代码 也 比较 长 ， 我 们 还 十 Se 。 在 oncreate() 方法 


中 仍然 先 古 去 获取 些 控 件 的 实例 ， 然 后 会 尝试 从 本 地 绥 存 中 读 取 天 气 数 
据 。 那 么 第 一 次 肯定 是 没有 缓存 的 ， 因此 就 会 人 Intent 中 取出 天 气 i 并 调 
用 requestweather() 方法 来 从 服务 器 请 求 天 气 数 据 。 注 意 ， 请 求 数据 的 时 
候 先 将 ScrollView 进 行 隐藏 ， 不 然 : 写 数 据 的 办 甸 看 上 去 会 很 奇怪 8 


requestweather() 方法 中 先是 使 用 了 参数 中 传 入 的 天 气 id 和 我 们 之 前 申请 好 
的 API Key 拼 装 出 一 个 接口 地 址 ， 接 着 调用 HttpUtil.sendokHttpRequest() 
方法 来 向 该 地 址 发 出 请 求 ， 服 务 器 会 将 相应 城市 的 天 气 信息 以 JSON 格 式 返 
回 。 然 后 我 们 在 onResponse() 回调 中 先 调 用 
Utility.handleweatherResponse( ) ne Et 
对 象 ， 再 将 当前 线程 切换 到 主线 程 。 然 后 进行 判断 ， 如 果 服 务 絮 返回 的 
status 状 态 是 ok， 就 7 此 时 将 返回 的 数据 缓存 到 
SharedPreferences 当 中 ， 并 调用 showweatherInfo() 方法 来 进行 内 容 显 示 。 


showweatherInfo( ) 方法 中 的 逻辑 就 比较 简单 了 ， 其 实 就 是 从 weather 对 象 
中 获取 数据 ， 然 后 显示 到 相应 的 控件 上 。 注 意 在 未 来 几 天 天 气 预报 的 部 分 
我 们 使 用 了 一 个 for 循 环 来 处 理 每 天 的 天 气 信息 ， 在 循环 中 动态 加 载 
forecast_item.xml 布 局 并 设置 相应 的 数据 ， 然 后 添加 到 父 布局 当中 。 设 置 完 
了 所 有 数据 之 后 ， 记 得 要 将 ScrollView 重 新 变 成 可 见 


这 样 我 们 就 将 首次 进入 WeatherActivity 时 的 逻辑 全 部 梳理 完了 ， 那 么 当下 一 
由 于 缓存 已 经 存在 了 ， 因 此 会 直接 解析 并 显示 
气 数据 ， 而 不 会 再 次 发 起 网 络 请 求 了 。 


处 理 完了 WeatherActivity 中 的 逻辑 ， 接 下 来 我 们 要 做 的 ， 就 是 如 何 从 省 市 县 
列表 界面 跳 转 到 天 气 界面 了 ， 修 改 ChooseAreaFragment 中 的 代码 ， 如 下 所 
示 : 


public class ChooseAreaFragment extends Fragment { 


Q@Override 
public void onActivityCreated(Bundle savedInstanceState) { 
super .onActivityCreated(savedInstancesState); 
lJistView,.setOonItemClickListener(new AdapterView.OnItemClickListener() { 
Q@Override 
public void onItemClick(AdapterView<?> parent, View view, int position, 

long id) { 

if (currentLevel == LEVEL PROVINCE) { 
selectedProvince = provinceList.get(position); 
gueryCities(); 

} else if (currentLevel == LEVEL_CITY) { 
selectedCity = cityList.get(position); 
gueryCounties(); 

} else if (currentLevel == LEVEL COUNTY) { 
String weatherId = countyList.get(position).getweatherId(); 
Intent intent = new Intent(getActivity(), WeatherActivity. 
class); 
intent.putExtra("weather_id", weatherId); 
startActivity(intent); 
getActivity().finish(); 


非常 简单 ， 这 里 在 onItemclick() 方法 中 加 入 了 一 个 if 判断 ， 如 果 当 前 级 别 


是 LEVEL_COUNTY ， 就 启动 WeatherActivity， 并 把 当前 选中 县 的 天 气 id 传 递 过 
六 


另外 ， 我 们 还 需要 在 MainActivity 中 加 入 一 个 缓存 数据 的 判断 才 行 。 修 改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
setCcontentView(R.1layout.activity_main); 
SharedPreferences prefs = PreferenceManager .getDefaultSharedpPreferences 
(this); 
if (prefs.getString("weather", null) != null) { 
Intent intent = new Intent(this, WeatherActivity.class); 
StartActivity(intent ) ， 
finish(); 


可 以 看 到 ， 这 里 在 oncreate() 方法 的 一 开始 完 从 SharedPreferences 文 件 中 读 
取 缓 存 数据 ， 如 果 不 为 null 就 说 明之 前 已 经 请 求 过 天 气 数据 了 ， 那 么 就 没 


必要 让 用 户 再 次 选择 城市 ， 而 是 直接 跳 转 到 WeatherActivity 即 可 。 


好 了 ， 现 在 重新 运行 一 下 程序 ， 然 后 选择 江苏 ~” 苏州 昆山， 结果 如 图 
14.21 所 示 。 
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图 14.21 显示 天 气 信息 
然后 我 们 还 可 以 向 下 滑动 查看 更 多 天 气 信息 ， 如 图 14.22 所 示 。 
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空气 质量 
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AQI 指 数 


生活 建议 
寻 适 度 : 白天 天 气 腑 好 ， 明 如 的 阳光 在 给 你 带 来 好 心情 
的 同时 ， 也 会 使 您 感到 有 些 热 ， 不 很 舒适 


洗车 指数 ; 较 不 宜 洗车 ， 未 来 一 天 无 雨 ， eb 如 
果 执 意 擦 洗 汽 车 ， 要 做 好 莹 上 污垢 的 心理 准备 


运动 建议 : 天 气 较 好 ， 但 由 于 风力 较 大 ， 推 荐 您 在 室内 
进行 低 强度 运动 ， 若 在 户外 运动 请 注意 避风 。 


4 | 


图 14.22 ”查看 更 多 天 气 信息 
14.5.4 ”获取 必 应 每 日 一 图 


虽说 现在 我 们 已 经 把 天 气 界 面 编写 得 非常 不 错 了 ， 不 过 和 市 场 上 的 一 些 天 
气 软件 的 界面 相 比 ， 仍 然 还 是 有 一 定 差距 的 。 出 色 的 天 气 软 件 不 会 像 我 们 
现在 这 样 使 用 一 个 固定 的 背景 色 ， 而 十 会 根据 不 同 的 城市 或 者 天 气 情况 展 
示 不 同 的 背景 图 片 。 

当然 实现 这 个 功能 并 不 复杂 ， 最 重要 的 是 需要 有 服务 器 的 接口 支持 。 不 过 
我 实在 是 没有 精力 去 准备 这 样 一 套 完善 的 服务 句 接 口 ， 那 么 为 了 不 让 我 们 
的 天 气 界面 过 于 单调 ， 这 里 我 准备 使 用 一 个 巧妙 的 办 法 。 


必 应 想必 你 肯定 不 会 阳 生 ， 这 征 一 个 由 微软 开发 的 搜索 引擎 网 站 。 这 个 网 
站 除了 提供 强大 的 搜索 功能 之 外 ， 还 有 一 个 非常 有 特色 的 地 方 ， 殊 是 它 每 


天 都 会 在 站 页 展示 一 张 精 美的 至 景 图 片 ， 如 图 14.23 所 示 。 


图 14.23 ” 必 应 的 首页 


由 于 这 些 图 片 都 是 由 必 应 精 挑 细 选 出 来 的 ， 并 且 每 天 都 会 变化 ， 如 果 我 们 
使 用 它们 来 作为 天 气 界 面 的 背景 图 ， 不 仅 可 以 让 界面 变 得 更 加 美观 ， 而 且 
解决 了 界面 一 成 不 变 、 过 于 单调 的 问题 。 


为 此 我 专门 准备 了 一 个 获取 必 应 每 日 一 图 的 接口 : 
http://guolin.tech/api/bing_pic ° 


访问 这 个 接口 ， 服 务 右 会 返回 今日 的 必 应 背景 图 链接 : 


http://cn.bing.com/az/hprichbg/rb/ChicagoHarborLH_ZH- 
CN9974330969_1920x1080.jpg 。 


然后 我 们 再 使 用 Glide 去 加 载 这 张 图 片 就 可 以 了 。 


辟 体 思路 束 是 这 么 人 简单， 下 面 开始 来 动手 实现 吧 。 甫 先 修改 
activity_weather.xml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="@color/colorPrimary"> 


<ImageView 
android:id="@+id/bing_pic_img" 


android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:scaleType="centerCrop" /> 


<ScrollView 


android:id="@+id/weather_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:scrollbars="none" 
android:overScrollMode="never"> 


</ScrollView> 


</FrameLayout> 


这 里 我 们 在 FrameLayout 中 添加 了 一 个 ImageView， 并 且 将 它 的 宽 和 高 都 设 
置 成 match_parent。 由 于 FrameLayout 默 认 情 况 下 会 将 控件 都 放置 在 左上 角 ， 


此 ScrollView 会 完全 禾 新 住 ImageView， 从 而 ImageView 也 束 成 为 背景 图 片 


了 。 


接着 修改 WeatherActivity 中 的 代码 ， 如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 


private ImageView bingPicImg， 


Q@Override 
protected void onCreate(Bundle SavedInstanceState) { 


} 
ys 


* 根据 天 气 id 请 求 城市 天 气 信 息 


0 


Super .onCreate(SavedInstanceState ) 

SetContentView(R.Layout ,activity_weather ) ， 
// 初始 化 各 控件 
bingPicImg = (ImageView) findViewById(R.id.bing_pic_img); 


String bingPic = prefs.getString("bing_pic", null); 
if (bingPic != null) { 
Glide.with(this).load(bingPic).into(bingPicImg); 
} else { 
loadBingPic(); 
} 


public void requestweather(final String weatherId) { 


} 


A 


* 加 载 必 应 每 图 


*/ 


lJoadBingPic(); 


private void loadBingPic() { 


String requestBingPic = "http://guolin.tech/api/bing_pic"; 
HttpUtil.sendOkHttpRequest(requestBingPic, new Callback() { 
Q@Override 
public void onResponse(Call call, Response response) throws IOException { 
final String bingPic = response.body().string(); 
SharedPreferences.Editor editor = PreferenceManager. 
getDefaultSharedPreferences(WeatherActivity.this).edit(); 
editor.putSstring("bing_pic", bingPic); 
editor.apply(); 
runonUiThread(new Runnable() { 
Q@Override 
public void run() { 
Glide.with(WeatherActivity.this).]load(bingPic).into 
(bingPicImg); 


了 于) 
} 


@Override 
public void onFailure(Call call, IOException e) { 
e.printStackTrace(); 
} 
}); 


可 以 看 到 ， 首先 在 oncreate() 方法 中 获取 了 新 增 控 件 ImageView 的 实例 ， 然 


尝试 从 SharedPreferences 中 读 取 绥 存 的 背景 图 片 。 如 果 有 绥 存 的 话 就 
使 用 Glide 来 加 载 这 张 图 片 ， 如 果 没 有 的 话 束 调 用 loadBingPic() 方法 去 请 求 
今日 的 必 应 背景 图 。 


loadBingPic() 方法 中 的 逻辑 就 非常 简单 了 ， 先 是 调用 了 

HttpUtil.sendokHttpRequest() 方法 获取 到 必 应 背景 图 的 链接 ， 然 后 将 这 个 
链接 缓存 到 SharedPreferences 当 中 ， 再 将 当 二 线程 切换 到 主线 程 ， oe 使 用 
Glide 来 加 载 这 张 图 片 就 可 以 了 。 男 外 需要 注意 ， 在 requestweather() 方法 
的 最 后 也 需要 调用 一 下 loadBingPic() 方法 ， 这 样 在 每 次 请 求 天 气 信息 的 时 
候 同时 也 会 刷新 背景 图 片 。 现 在 重 狐 运行 一 下 程序 ， 效 果 如 图 14.24 所 示 。 
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图 14.24 在 天 气 界面 显示 必 应 背景 图 


皇 么 样 ? 虽说 只 是 换 了 一 张 育 景 图 而 已 ， 但 是 整个 界面 的 视觉 体验 束 完 全 
不 一 样 了 ， 瞬 间 提 升 了 好 几 个 档次 。 而 且 我 们 的 育 景 图 并 不 是 一 成 不 变 
的 ， 每 天 都 会 是 不 同 的 图 片 ， 永 远 给 人 一 种 耳目 一 新 的 感觉 。 


不 过 如 果 你 仔细 观察 图 14.24， 你 会 发 现 背 景 图 并 没有 和 状态 栏 融合 到 一 
起 ， 这 样 的 话 视觉 体验 天 还 是 没有 达到 最 佳 的 效果 。 虽 说 我 们 在 12.7.2 小 地 
已 经 学 习 过 如 何 将 背景 图 和 状态 栏 融合 到 一 起 ， 但 当时 是 借助 Design 
Support 库 完成 的 ， 而 我 们 这 个 项 目 中 并 没有 引入 Design Support 库 。 


当然 如 果 还 是 模仿 12.7.2 小 节 的 做 法 ， 引 入 Design Support 库 ， 然 后 藤 套 
CoordinatorLayout 、 AppBarLayout 、 CollapsingToolbarLayout 等 布局 ， 也 能 
实现 背景 图 和 状态 栏 融 合 到 一 起 的 效果 ， 不 过 这 样 做 就 过 于 矿 烦 了 ， 这 里 


| 实现 方式 。 修 改 WeatherActivity 中 的 代码 ， 如 
下 所 未 


public class WeatherActivity extends AppCompatActivity { 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
super.onCreate(savedInstanceState); 
if (Build.VERSION.SDK_INT >= 21) { 
View decorView = getwWindow().getDecorView(); 


View.SYSTEM_ UI_FLAG_ LAYOUT_FULLSCREEN 
| View.SYSTEM_UI_FLAG_ LAYOUT_STABLE); 
getwindow().setStatusBarColor (Color .TRANSPARENT ) ， 


} 
setCcontentView(R.1layout.activity weather); 


由 于 这 个 功能 是 Android 5.0 及 以 上 的 系统 才 文 持 的 ， 因 此 我 们 移 在 代码 中 做 
了 一 个 系统 版 本 号 的 判断 ， 只 有 当 和 版 本 号 大 于 或 等 于 21， 也 就 是 5.0 及 以 上 
系统 时 才 会 执行 后 面 的 代码 。 


接着 我 们 调用 了 getwindow() .getDecorView() 方法 拿 到 当前 活动 的 
DecorView， 再 调用 它 的 setsystemuivisibility() 方法 来 改变 系统 UI 的 显 
示 ， 这 里 传 入 View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN 和 
View.SYSTEM_UI_FLAG_LAYOUT_STABLE 就 表示 活动 的 布局 会 显示 在 状态 栏 上 
面 ， 最 后 调用 一 下 setstatusBarcolor() 方法 将 状态 栏 设 置 成 透明 色 。 


仪 仅 这 些 代 码 束 可 以 实现 让 背景 图 和 状态 栏 融合 到 一 起 的 效果 了 。 不 过 ， 
如 有 条 运 行 一 下 程序 ， 你 会 发 现 还 是 有 些 问 题 ， 天 气 界 面 的 头 布 局 几乎 和 系 
统 状态 栏 紧 贴 到 一 起 了 ， 如 图 14.25 所 示 。 
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图 14.25 头 布 局 和 状态 栏 紧 贴 在 一 起 


这 是 由 于 系统 状态 栏 已 经 成 为 我 们 布局 的 一 部 分 ， 因 此 没有 单独 为 它 留 出 
空间 。 当 然 ， 这 个 问题 也 是 非常 好 解决 的 ， 借 助 
android:fitssystemwindows 属性 承 可 以 了 。 修 改 activity_weatherxml 中 的 代 
码 ， 如 下 所 示 : 


<FrameLayout 
xmlns:android="http://schemas.android,.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="@color/colorPrimary"> 


<ScrollView 
android:id="@+id/weather_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:scrollbars="none" 
android:overScrollMode="never"> 


<LinearLayout 
android:orientation="vertical" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:fitsSystemwindows="true"> 


</LinearLayout> 


</ScrollView> 


</FrameLayout> 


这 里 在 ScrollView 的 LinearLayout 中 增加 了 android:fitssystemwindows 属 
性 ， 设 置 成 true 就 表示 会 为 系统 状态 栏 留 出 空间 。 现 在 重新 运行 一 下 代 
码 ， 效 采 如 图 14.26 所 示 。 
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图 14.26 为 系统 状态 栏 留 出 空间 
OK， 这 样 第 三 阶段 的 开发 工作 也 都 完成 了 ， 我 们 把 代码 提交 一 


git add . 
git commit -m "加 入 显示 天 气 信 息 的 功能 。" 
git push origin master 


14.6 ”手动 更 新 天 气 和 切换 城市 


经 过 第 三 阶段 的 开发 ， 现 在 酷 欧 天 气 的 主体 功能 已 经 有 了 ， 不 过 你 会 发 现 
目前 存在 着 一 个 比较 严重 的 pug， 就 是 当 你 选中 了 某 一 个 城市 之 后 ， 就 没 法 
再 去 查看 其 他 城市 的 天 气 了 ， 即 使 退出 程序 ， 下 次 进来 的 时 候 还 会 直接 跳 
转 到 WeatherActivity 。 


因此 ， 在 第 四 阶段 中 我 们 要 加 入 切换 城市 的 功能 ， 并 且 为 了 能 够 实时 获取 
到 最 新 的 天 气 ， 我 们 还 会 加 入 手动 更 新 天 气 的 功能 

14.6.1 手动 更 新 天 气 

先 来 实现 一 下 手动 更 新 天 气 的 功能 。 由 于 我 们 在 上 一 节 中 对 天 气 信息 进行 
了 缓存 目前 每 次 展示 的 都 是 缓存 中 的 数据 ， 因 此 现在 非常 需要 一 种 方式 
能 够 让 用 户 手动 更 新 天 气 信息 。 


至 于 如 何 触发 更 新 事件 呢 ? 这 里 我 准备 采用 下 拉 刷 新 的 方式 ， 正 好 我 们 之 
前 也 学 过 下 拉 刷 靳 的 用 法 ， 实 现 起 来 会 比较 简单 。 


首先 修改 activity_weatherxml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="@color/colorPrimary"> 


<android,.support.v4.widget.SwipeRefreshLayout 
android:id="@+id/swipe_refresh" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


<ScrollView 
android:id="@+id/weather_layout" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:scrollbars="none" 
android:overScrollMode="never"> 


</ScrollView> 


</android.support.v4.widget.SwipeRefreshLayout> 


</FrameLayout> 


可 以 看 到 ， 这 里 在 ScrollView 的 外 面 又 持 套 了 一 层 SwipeRefreshLayout， 这 


样 ScrollView 丈 和 目 动 拥有 下 拉 刷 新 功能 了 。 
然后 修改 WeatherActivity 中 的 代码 ， 加 入 更 狐 天 气 的 处 理 逻 辑 ， 如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 


public SwipeRefreshLayout SwipeRefresh 
private String mweatherId 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 


} 


大 
大 


大 


/ 


super.onCreate(savedIinstanceState); 


swipeRefresh = (SwipeRefreshLayout) findViewById(R.id.swipe_refresh); 
swipeRefresh.setCcolorSchemeResources(R.color.colorPrimary); 
SharedPreferences prefs = PreferenceManager. 
getDefaultSharedPreferences(this); 
String weatherString = prefs.getSstring("weather", null]l); 
If (weatherString != null) { 
// 有 缓存 时 直接 解析 天 气 数据 
Weather weather = Utility,.handleweatherResponse(weatherString ) ， 
mweatherId = weather.basic.weatherId; 
ShowweatherInfo(weather ); 
} else { 
// 无 缓存 时 去 服务 器 查询 天 气 
mweatherId = getIntent().getStringExtra("weather_id")， 
weatherLayout.setVisibility(View.INVISIBLE); 
requestweather (mweatherId); 


} 
swipeRefresh.setOnRefreshListener(new SwipeRefreshLayout. 
OnRefreshListener() { 
@Override 
public void onRefresh() { 
requestweather (mweatherId); 
} 


}); 


根据 天 气 id 请 求 城市 天 气 信息 


public void requestweather(final String weatherId) { 


String weatherUrl = "http://guolin.tech/api/weather?cityid=" + 
weatherId + "&key=bc0418b57b2d4918819d3974ac1285d9"，; 

HttpUtil.sendOkHttpRequest(weatherUrl, new Callback() { 
@Override 


public void onResponse(Call call, Response response) throws IOException { 


runonUiThread(new Runnable() { 
Q@Override 
public void run() { 


if (weather != null && "ok".equals(weather.status)) { 

SharedPreferences.Editor editor = PreferenceManager. 
getDefaultSharedPreferences(WeatherActivity. 
this).edit(); 

editor.putString("weather", responseText); 
editor.apply(); 
mweatherId = weather.basic.weatherId; 
showwWeatherInfo(weather); 

} else { 


Toast .makeText (WeatherActivity.this, "获取 天 气 信 息 失 败 "， 
Toast .LENGTH_SHORT) .show( ); 


} 


swipeRefresh.setRefreshing(false); 


}); 
站 


@Override 
public void onFailure(Call call, IOException e) { 
e.printStackTrace(); 
runonUiThread(new Runnable() { 
@override 
public void run() { 
Toast .makeText(WeatherActivity,this，" 获 取 天 气 信息 失败 "， 
Toast .LENGTH_SHORT) .show( ) ， 
swipeRefresh.setRefreshing(false); 


}); 
} 


}); 
lJoadBingPic(); 


修改 的 代码 并 不 算 多 ， 首 先 在 oncreate() 方法 中 获取 到 了 
SwipeRefreshLayout 的 实例 ， 然后 调用 setcolorschemeResources() 方法 来 设 
年 下 所 刷新 过 度 条 的 颜色 ， 这 里 我 们 ; EE Dh te 
条 的 颜色 了 。 接 着 定义 了 一 个 mweatherId 变量 ， 用 于 记录 城市 的 天 气 id， 
后 调用 setonRefreshListener() 方法 来 设置 一 个 下 拉 刷 新 的 监听 絮 ， 当 触发 


了 下 拉 刷 新 操作 的 时 候 ， 束 会 回调 这 个 监听 器 的 onRefresh() 方法 ， 我 们 在 


各 


这 


然 


里 去 调用 requestweather() 方法 请 求 天 气 信息 职 可 以 了 。 


男 外 不 要 起 记 ， 当 请 求 结束 后 ， 还 需要 调用 SwipeRefreshLayout 的 
setRefreshing() 方法 并 传 入 false ， 用 于 表示 刷新 事件 结束 ， 并 隐藏 刷新 


现在 重新 运行 一 下 程序 ， 并 在 屏 医 的 主 寞 面 癌 下 拖 动 ， 效 末 如 图 14.27 所 
泵 “。 
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图 14.27 手动 更 新 天 气 
更 新 完 天 气 信息 之 后 ， 下 拉 进 度 条 会 自动 消失 。 


14.6.2 ”切换 城市 


完成 了 手动 更 新 天 气 的 功能 ， 接 下 来 我 们 继续 实现 切换 城市 功能 。 


既然 是 要 切换 城市 ， 那 么 束 肯 定 需要 怖 历 全 国 省 市 县 的 数据 ， 而 这 个 功能 
我 们 早 在 14.4 节 就 已 经 完成 了 ， 并 且 当 时 考 虚 为 了 方便 后 面 的 复 用 ， 特 意 选 
择 了 在 碎片 当中 实现 。 因 此 ， 我 们 其 实 只 需要 在 天 气 界 面 的 布局 中 引入 这 
个 雁 上 请， 融 可 以 快速 集成 切换 城市 功能 了 。 


虽说 实现 原理 很 简 单 ， 但 是 显然 我 们 也 不 可 能 让 引入 的 碎片 把 天 气 界面 让 
挡住 ， 这 叉 该 怎么 办 昵 ?还 记得 12.3 和 学 过 的 滑动 菜单 功能 吗 ? 将 碎片 放 入 
到 滑动 菜单 中 真是 再 合适 不 过 了 ， 正 和 营 情况 下 它 不 占据 主 界面 的 任何 空 

间 ， 想 要 切换 城市 的 时 候 只 需要 通过 滑动 的 方式 将 荣 单 显示 出 来 就 可 以 

了 了。 


下 面 我 们 就 按照 这 种 思路 来 实现 。 首 先 按照 Material Design 的 建议 ， 我 们 需 
要 在 头 布局 中 加 入 一 个 切换 城市 的 按钮 ， 不 然 的 话 用 户 可 能 根本 就 不 知道 
屏幕 的 左 侧 边 绿 是 可 以 拖 动 的 。 修 改 title.xml 中 的 代码 ， 如 下 所 示 : 


<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="?attr/actionBarSize"> 


<Button 
android:id="@+id/nav_button" 
android:layout_width="30dp" 
android:layout_height="30dp" 
android:layout_marginLeft="10dp" 
android:layout_alignParentLeft="true" 
android:layout_centerVertical="true" 
android:background="@drawable/ic_home" /> 


</RelativeLayout> 


这 里 添加 了 一 个 Button 作 为 切换 城市 的 按钮 ,并且 让 它 居 左 显 示 。 男 外 ,我 
提前 准备 好 了 一 张 图 片 来 作为 按钮 的 背景 图 。 


接着 修改 activity_weatherxml 布 局 来 加 入 请 动 菜 单 功 能 ， 如 下 所 示 : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:background="@color/colorPrimary"> 


<android,.support.v4.widget.DrawerLayout 
android:id="@+id/drawer_layout" 
android:layout_width="match_parent" 


android:layout_height="match_parent"> 


<android,.support.v4.widget.SwipeRefreshLayout 
android:id="@+id/swipe_refresh" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


</android.support.v4.widget.SwipeRefreshLayout> 


<fragment 
android:id="@+id/choose_area fragment" 
android:name="com.coolweather .android.ChooseAreaFragment" 
android:layout_width="match_parent" 
android:layout_height="match_parent" 
android:layout_gravity="start" 
/> 


</android.support.v4.widget.DrawerLayout> 


</FrameLayout> 


可 以 看 到 ， 我 们 在 SwipeRefreshLayout 的 外 面 义 藤 套 了 一 层 DrawerLayout 。 


DrawerLayout 中 的 第 一 个 子 控件 用 于 作为 主屏 幕 中 显示 的 内 容 ， 第 二 个 子 控 
件 用 于 作为 渭 动 菜单 中 显示 的 内 容 ， 因 此 这 里 我 们 在 第 二 个 子 控件 的 位 置 
添加 了 用 于 避 历 省 市 县 数据 的 碎片 。 


接 下 来 需要 在 WeatherActivity 中 加 入 请 动 荣 单 的 逻辑 处 理 ， 修 改 
WeatherActivity 中 的 代码 ， 如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 


public DrawerLayout drawerLayout 


private Button navButton; 


QOverride 
protected void onCreate(Bundle SavedInstanceState) { 
Super .oncCreate(SavedInstanceState ) 


drawerLayout = (DrawerLayout) findViewById(R.id.drawer_layout); 
navButton = (Button) findViewById(R.id.nav_button); 


navButton.setOonClickListener(new View.OnClickListener() { 
Q@Override 
public void onClick(View v) { 
drawerLayout .openDrawer (GravityCompat .START); 
} 
}); 


(al 


首先 在 oncreate() 方法 中 获取 到 新 增 的 DrawerLayout 和 Button 的 实 
0 然后 在 Button 的 点 击 事件 中 调用 DrawerLayout 的 openprawer() 方法 来 打 
消 动 菜单 束 可 以 了 。 


不 过 现在 还 没有 结束 ， 因 为 这 仪 仅 是 打开 了 滑动 末 单 而 已 ， 我 们 还 需要 处 
理 切 换 城 市 后 的 逻辑 才 行 。 这 个 工作 残 必 须要 在 ChooseAreaFragment 中 进行 
了 ， 因 为 之 前 选中 了 某 个 城市 后 是 跳 转 到 WeatherActivity 的 ， 而 现在 由 于 我 
们 本 来 就 是 在 WeatherActivity 当 中 的 ， 因 此 并 不 需要 跳 转 ， 只 是 去 请 求 新 选 

择 城 市 的 天 气 信息 就 可 以 了 。 


那么 很 吕 然 这 里 我 们 需要 根据 ChooseAreaFragment 的 不 同 状 态 来 进行 不 同 的 
逻辑 处 理 ， 修 改 ChooseAreaFragment 中 的 代码 ， 如 下 所 示 : 


public class ChooseAreaFragment extends Fragment { 


QOverride 

public void onActivityCreated(Bundle savedInstanceState) { 
super .onActivityCreated(SavedInstanceState ) ， 
listView,.setOonItemClickListener(new AdapterView.OnItemClickListener() { 


@Override 
public void onItemClick(AdapterView<?> parent, View view, int position, 
long id) { 


if (currentLevel == LEVEL PROVINCE) { 
selectedProvince = provinceList.get(position); 
queryCities(); 

} else if (currentLevel == LEVEL_CITY) { 
selectedCity = cityList.get(position); 
gueryCounties(); 

} else if (currentLevel == LEVEL COUNTY) { 

String weatherId = countyList.get(position).getweatherId(); 

if (getActivity() instanceof MainActivity) { 

Intent intent = new Intent(getActivity(), WeatherActivity. 
class); 

intent.putExtra("weather_id", weatherId); 

startActivity(intent); 

getActivity().finish(); 

} else if (getActivity() instanceof WeatherActivity) { 
WeatherActivity activity = (WeatherActivity) getActivity(); 
activity.drawerLayout.closeDrawers(); 
activity.swipeRefresh.setRefreshing(true); 
activity.requestweather (weatherId); 


| 
这 里 我 使 用 了 一 个 Java 中 的 小 技巧 ，instanceof 天 键 字 可 以 用 来 判断 一 个 对 
象 是 否 属于 某 个 类 的 实例 。 我 们 在 碎片 中 调用 getActivity() 方法 ， 然 后 配 
合 instanceof 关键 字 ， 束 能 轻松 判断 出 该 碎片 是 在 MainActivity 当 中 ， 还 是 
在 WeatherActivity 当 中 。 如 果 是 在 MainActivity 当 中 ， 那 么 处 理 逻 辑 不 变 。 
如 果 是 在 WeatherActivity 当 中 ， 那 么 就 关闭 滑动 茉 单 ， 显 示 下 拉 刷 新 进度 
条 ， 然 后 请 求 新 城市 的 天 气 信 息 。 


这 样 我 们 就 把 切换 城市 的 功能 全 部 完成 了 ， 现 在 可 以 重新 运行 一 下 程序 ， 
效果 如 图 14.28 所 示 。 
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图 14.28 ”拥有 切换 城市 按钮 的 天 气 界面 


可 以 看 到 ， 标 题 栏 上 多 出 了 一 个 用 于 切换 城市 的 按钮 。 点 击 该 按钮 ， 或 者 
ee 忠 能 让 渭 动 菜单 界面 显示 出 来 了 ， 如 图 14.29 
a 


图 14.29 显示 滑动 菜单 界面 


然后 我 们 束 可 以 在 这 里 切换 其 他 城市 了 。 选 中 城市 之 后 滑动 苹 单 会 目 动 关 
闭 ， 并 且 主 界面 上 的 天 气 信息 也 会 更 新 成 你 选择 的 那个 城市 。 


这 样 ， 第 四 阶段 的 开发 任务 也 完成 了 。 当 然 ， 仍 然 不 要 起 记 提 交代 码 。 


git add . 
git commit -m "新 增 切换 城市 和 手动 更 新 天 气 的 功能 。" 
git push origin master 


14.7 “后台 目 动 更 新 天 气 


为 了 要 让 酷 欧 天 气 更 加 智能 ， 在 第 五 阶段 我 们 准备 加 入 后 台 自 动 更 新 天 气 
区 能 这 这 样 就 可 以 尽 可 能 地 保证 用 户 每 次 打开 软件 时 看 到 的 都 是 最 新 的 
天 气 信息 。 


想 实现 上 述 功能 ， 就 需要 创建 一 个 长 期 在 后 台 运 行 的 定时 任务 ， 这 个 功 
EB 肯 定 是 难 不 倒 你 的 ， 因 为 我 们 在 13.5 市 中 就 已 经 学 习 过 了 。 


首先 在 service 包 下 渐 建 一 个 服务 ， 右 击 


com.cCoolweather.android.service 一 New 一 Service 一 Service ， 
AutoUpdateService， 并 将 Exported 和 Enabled 这 两 个 属性 都 义 中 。 然 后 修改 
AutoUpdateService 中 的 代码 ， 如 下 所 示 : 


public class AutoUpdateService extends Service { 


QOverride 
public IBinder onBind(Intent intent) { 
return null; 


} 


Q@Override 
public int onStartCcommand(Intent intent, int flags, int StartId) { 
updateweather( ); 
updateBingPic(); 
AlarmManager manager = (AlarmManager) getSystemService(ALARM SERVICE); 
int anHour = 8 * 60 * 60 * 1000; // 这 是 8 小 时 的 毫秒 数 
long triggerAtTime = SystemClock.elapsedRealtime() + anHour ， 
Intent i = new Intent(this, AutoUpdateService.class); 
PendingIntent pi = PendingIntent.getService(this, 0, i, 0); 
manager .cancel(pi); 
manager .set(AlarmManager .ELAPSED_ REALTIME_ WAKEUP, triggerAtTime, pi); 
return super.onstartCcommand(intent, flags, startId); 


} 


Pe 
的 更 新 天 信息 
本 
private void updateweather(){ 
SharedPreferences prefs = PreferenceManager .getDefaultSharedPreferences(this); 
String weatherString = prefs.getString("weather"，nul1) ， 
if (weatherString != null) { 
// 有 缓存 时 直接 解析 天 气 数据 
Weather weather = Utility,.handleweatherResponse(weatherString ) ， 
String weatherId = weather ,basic,weatherId 


String weatherUrl] = "http://guolin.tech/api/weather?cityid=" + 
weatherId + "&key=bc0418b57b2d4918819d3974ac1285d9"，; 
HttpUtil.sendOokHttpRequest(weatherUrl, new Callback() { 
Q@Override 
public void onResponse(Call call, Response response) throws 
IOException { 
String responseText = response.body().string(); 
Weather weather = Utility.handleweatherResponse(responseText); 
If (weather != null && "ok".equals(weather.status)) { 


SharedpPreferences.Editor editor = PreferenceManager. 
getDefaultSharedPreferences(AutoUpdateService.this). 
edit(); 
editor.putString("weather", responseText); 
editor.apply(); 


} 


QOverride 
public void onFailure(Call call, IOException e) { 
e.printSstackTrace( ); 


} 
})3 
} 
} 
se 
* 更 新 必 应 每 日 一 图 
*/ 


private void updateBingPic() { 
String requestBingPic = "http://guolin.tech/api/bing_pic"; 
HttpUtil.sendOkHttpRequest(requestBingPic, new Callback() { 
@Override 
public void onResponse(Call call, Response response) throws IOException { 
String bingPic = response.body().string(); 
SharedPreferences.Editor editor = PreferenceManager .getDefault 
SharedPreferences(AutoUpdateService.this).edit(); 
editor.putSstring("bing_pic", bingPic); 
editor.apply(); 
} 


@Override 


public void onFailure(Call call, IOException e) { 
e.printStackTrace(); 


}); 


可 以 看 到 ， 在 onstartcommand() 方法 中 先是 调用 了 updateweather() 方法 来 
更 新 天 气 ， 然 后 调用 了 updateBingpPic() 方法 来 更 新 背景 图 片 。 这 里 我 们 将 
更 新 后 的 数据 直接 存储 到 SharedPreferences 文 件 中 就 可 以 了 ， 因 为 打开 
WeatherActivity 的 时 候 都 会 优先 从 SharedPreferences 绥 存 中 读 取 数据 。 


之 后 束 是 我 们 学 习 过 的 创建 定时 任务 的 技巧 了 ， 为 了 保证 软件 不 会 消耗 过 
多 的 流量 ， 这 里 将 时 间 间 隔 设 置 为 8 小 时 ，8 小 时 后 AutoUpdateReceiver 的 
onstartCommand() 方法 吏 会 重新 执行 ， 这 样 也 残 实 现 后 台 定 时 更 新 的 功能 


不 过 ， 我 们 还 需要 在 代码 某 处 去 激活 AutoUpdateService 这 个 服务 才 行 。 修 
改 WeatherActivity 中 的 代码 ， 如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 


里 并 展示 Weather 实 体 类 中 的 数据 。 


private void showweatherIinfo(Weather weather) { 


weatherLayout.setVisibility(View.VISIBLE); 
Intent intent = new Intent(this, AutoUpdateService.class); 
startService(intent); 

} 


可 以 看 到 ， 这 里 在 showweatherInfo() 方法 的 最 后 加 入 启动 
AutoUpdateService 这 个 服务 的 代码 ， 这 样 只 要 一 旦 选中 了 某 个 城市 并 成 功 
更 新 天 气 之 后 ，AutoUpdateService 职 会 一 直 在 后 台 运 行 ， 并 保证 每 8 小 时 更 
新 一 次 天 气 。 


现在 可 以 再 提交 一 下 代码 : 


git add . 
git commit -m "增加 后 台 自 动 更 新 天 气 的 功能 。" 
git push origin master 


14.8 ”修改 图 标 和 名 称 


目前 的 酷 欧 天 人 气 看 起 来 还 不 太 像 是 一 个 正式 的 软件 ， 为 什么 呢 ? 因为 都 还 
没有 一 个 像样 的 图 标 呢 。 一 直 使 用 Android Studio 自 动 生成 的 图 标 确实 不 太 
合适 ， 是 时 候 需 要 换 一 下 了 。 


这 里 我 事先 准备 好 了 一 张 图 片 来 作为 软件 图 标 ， 由 于 我 也 不 是 搞 美 术 的 ， 
因此 图 标 设计 得 非常 简单 ， 如 图 14.30 所 示 。 


图 14.30 酷 欧 天 气 的 图 标 


论 上 来 讲 ， 我 们 应 该 给 这 个 图 标 提 供 几 L 种 不 同 分 > 辩 率 的 版 本 ， 然 后 分 别 
人 辨 率 的 mipmap 目 录 下 ， 这 里 简单 起 见 ， 0 张 图 
了 。 将 这 张 图 片 命名 成 logo.png， 放 入 到 所 有 以 mipmap 开 头 的 目录 下 ， 然 后 
修改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.coolweather .android"> 


<uses-permission android:name="android.permission.INTERNET" /> 


<application 
android:name="org.1litepal.LitePpalApplication" 
android:allowBackup="true" 
android:icon="@mipmap/l1ogo" 
android:label="@string/app_name" 
android:supportsRtl1="true" 
android:theme="@style/AppTheme"> 


</application> 


</manifest> 


这 里 将 <application> 标签 的 android:icon 属性 指定 成 @mipmap/logo 就 可 以 
修改 程序 图 标 了 。 接 下 来 我 们 还 需要 修改 一 下 程 / 子 的 和 名称， 关于 
res/values/string.xml 文 件 ， 其 中 app_name 对 应 的 就 是 程序 名 称 ， 将 它 修改 成 
酷 欧 天 气 即 可 ， 如 下 所 示 : 


<resources> 
<string name="app_name"> 酷 欧 天 气 </string> 
</resources> 


现在 重新 运行 一 吉 程 序 ， 这 时 观察 酪 欧 天 气 的 桌面 图 标 ， 如 图 14.31 所 示 。 


~ 创口 


图 14.31 手机 桌面 图 标 
养 成 良好 的 习惯 ， 仍 然 不 要 忘记 提交 代码 。 


git add . 
git commit -m "修改 程序 图 标 和 名 称 。" 


git push origin master 


这 样 我 们 就 终于 大 功 告 成 了 ! 


14.9 ”你 还 可 以 做 的 事情 


经 过 五 个 阶段 的 开发 ， 酯 欧 天 气 已 经 是 一 个 完善 、 成 熟 的 软件 了 吗 ? 哩 
咖 ， 还 差 得 远 呢 ! 现在 的 酯 欧 天 气 只 能 说 是 具备 了 一 些 最 基本 的 功能 ， 和 
那些 商用 的 天 气 软件 比 起 来 还 有 很 大 的 兰 距 ， 因 此 你 仍然 还 有 非常 巨大 的 
发 挥 空间 来 对 它 进行 完善 。 


比如 说 以 下 功能 是 你 可 以 考虑 加 入 到 酷 欧 天 气 中 的 。 

。 增 加 设置 选项 ， 让 用 户 选 择 是 否 允 许 后 台 目 动 更 新 天 气 ， 以 及 设 定 更 
新 的 频率 。 

。 优化 软件 界面 ， 提 供 多 套 与 天 气 对 应 的 图 片 ， 让 程序 可 以 根据 不 同 的 
天 气 目 动 切换 背景 

。 允许 选择 多 个 城市 ， 可 以 同时 观察 多 个 城市 的 天 气 信 息 ， 不 用 来 回 切 
换 。 


。 提供 更 加 完整 的 天 气 信息 ， 目 前 我 们 只 使 用 了 和 风 天 气 返回 的 一 小 部 
分 数据 而 已 。 


另外 ， 由 于 酷 欧 天 气 的 源码 已 经 托管 在 了 GitHub 上 面 ， 如 采 你 想 在 现 有 代 
码 的 基础 上 继续 对 这 个 项 目 进行 完善 ， 束 可 以 使 用 GitHub 的 Fork 功 能 。 


首先 登录 你 上 自己 的 GitHub 账 号 ， 然 后 打开 酷 欧 天 气 版 本 库 的 主页 : 
https://github.com/guolindev/coolweather ， 这 时 在 页 面 头 部 的 最 右 侧 会 有 一 
个 Fork 按 钮 ， 如 图 14.32 所 示 。 


©OWatchv 0 会 Star 0 WFork 0 


图 14.32” GitHub Fork 按 钮 


扩 击 一 下 Fork 按 钮 束 可 以 将 酷 欧 天 气 这 个 项 目 复制 一 份 到 你 的 账号 下 ， 青 
使 用 git clone 命令 将 它 殉 隆 到 本 地 ， 然 后 你 束 可 以 在 现 有 代码 的 基础 上 随 
心 所 欲 地 添加 任何 功能 并 提交 了 。 


第 15 章 最 后 一 步 
到 360 应 用 商店 


应 用 已 经 开发 出 来 了 ， 下 一 步 我 们 需要 思考 推广 方面 的 工作 。 那 么 如 何 才 
能 让 更 多 的 用 户 知道 并 使 用 我 们 的 应 用 程序 呢 ? 在 手机 领域 ， 最 常见 的 做 
法 就 是 将 程序 发 布 到 某 个 应 用 商店 中 ， 这 样 用 户 就 可 以 通过 商店 找到 我 们 
的 应 用 程序 ， 然 后 轻松 地 进行 下 载 和 安 狼 。 


说 到 应 用 商店 ， 在 Android 领 域 真 的 可 以 称 得 上 是 百家争鸣 ， 除 了 谷歌 官方 
推出 的 Google Play 之 外 ， 在 中 国 还 有 像 360、 吏 豆 奖 、 百 度 、 应 用 宝 等 知名 
的 应 用 商店 。 当 然 ， 这 些 商店 所 提供 的 功能 都 是 比较 类 似 的 ， 发 布 应 用 的 

方法 也 大 同 小 异 ， 因 此 这 里 我 们 残 只 学 习 如 何 将 应 用 发 布 到 360 应 用 商店 ， 

其 他 应 用 商店 的 发 布 方法 相信 你 完全 可 以 自己 摸索 出 来 。 


15.1 生成 正式 签名 的 APK 文 件 


之 前 我 们 一 直 都 是 通过 Android Studio 来 将 程序 安装 到 手机 上 的 ， 而 它 背 后 
实际 的 工作 流程 是 ，Android Studio 会 将 程序 代码 打包 成 一 个 APK 文 件 ， 然 
后 将 这 个 文件 传输 到 手机 上 ， 最 后 再 执行 安装 操作 。Android 系 统 会 将 所 有 
的 APK 文 件 识别 为 应 用 程序 的 安装 包 ， 类 似 于 Windows 系 统 上 的 EXE 文 件 。 


将 应 用 发 布 


但 并 不 是 所 有 的 APK 文 件 都 能 成 功 安装 到 手机 上 ，Android 系 统 要 求 只 有 签 
名 后 的 APK 文 件 才 可 以 安装 ， 因 此 我 们 还 需要 对 生成 的 APK 文 件 进行 签名 
才 行 。 那 么 你 可 能 会 有 疑问 了 ， 和 直接 通 过 Android Studio 来 运行 程序 的 时 候 
好 像 并 没有 进行 过 签名 操作 啊 ， 为 什么 还 能 将 程序 安装 到 手机 上 呢 ? 这 是 
因为 Android Studio 使 用 了 一 个 默认 的 keystore 文 件 帮 有 我 们 目 动 进行 了 签名 。 
点 击 Android Studio 右 侧 工 具 栏 的 Gradle -项 目 名 一 :app 一 Tasks 一 android， 
双击 signingReport， 结 果 如 图 15.1 所 示 。 


Variant: debug 
Config: debug 


Store: C:\Users\Administrator\. android\debug. keystore 


图 15.1 查看 默认 的 keystore 文 件 


也 就 是 说 ， 我 们 所 有 通过 Android Studio 来 运行 的 程序 都 是 使 用 了 这 个 
debug.keystore 文 件 来 进行 签名 的 。 不 过 这 仅仅 适用 于 开发 阶段 而 已 ， 现 在 
酷 欧 天 气 已 经 快要 发 布 了 ， 要 使 用 一 个 正式 的 keystore 文 件 来 进行 签名 才 
行 。 下 面 我 们 天 来 学 习 一 下 ， 如 何 生成 一 个 带 有 正式 签名 的 APK 文 件 。 


15.1.1 使 用 Android Studio 生 成 


先 学 习 一 下 如 何 使 用 Android Studio 来 生成 正式 签名 的 APK 文 件 。 点 击 
Android Studio 导 航 栏 上 的 Build- Generate Signed APK， 首 次 点 击 可 能 会 提 
示 让 我 们 输入 操作 系统 的 密码 ， 如 图 15.2 所 示 。 


中 
Enter Master Password 


2 peed 


Master password is required to unlock the password database. 
The password database will be unlocked during this session 
for all subsystems. 


Reaquested by: Keystore Step 


rep | WE | oon | | test 


图 15.2 输入 操作 系统 密码 提示 框 


输入 密码 之 后 点 击 OK， 则 会 弹出 如 图 15.3 所 示 的 创建 签名 APK 对 话 框 。 


网 Generate Signed APK 


| Create new... | | Choose existing... | 


Key store password: 


Key alias: | 2 


Key password: 


[] Remember passwords 


| previous | | cancel | | Help | 


图 15.3 创建 签名 APK 对 话 框 


由 于 目前 我 们 还 没有 一 个 正式 的 keystore 文 件 ， 所 以 应 该 点 击 Create new 按 
钮 ， 然 后 会 弹出 一 个 新 的 对 话 框 来 让 我 们 填写 创建 keystore 文 件 所 必要 的 信 
息 。 根 据 自 己 的 实际 情况 进行 填写 就 行 了 ， 如 图 15.4 所 示 。 


| 
网 New Key Store 


Key store path: | Ci\Users\Administrato\Documents\guolin,jks 


Password: | Confirm: | 


Key 


Alias: 


Password: 


Validity (years): 


-Certificate—— 


First and Last Name: | Guo Lin 


Organizational Unit: | Personal 


Organization: Guo Lin 


City or Locality: Suzhou 


State or Province: Jiangsu 


Country Code (XX): 86 


图 15.4 填写 keystore 文 件 信息 

这 里 需要 注意 ， 在 Validity 那 一 栏 填写 的 是 keystore 文 件 的 有 效 时 长 ， 单 位 是 
年 ， 一 般 建议 时 间 可 以 填 得 长 一 些 ， 比 如 我 填 了 30 年 。 然 后 点 击 OK， 这 时 
我 们 刚才 十 写 的 信息 会 目 动 填充 到 创建 签名 APK 对 话 框 当中 ， 如 图 15.5 所 
示 “。 


二 
网 Generate Signed APK 


Key store path: | Ci\Users\Administrator\Documents\guolinjks | 


| Create new... | | Choose existing... | 


Key store password: 


Key alias: 


Key password: 


[DD Remember passwords 


| Previous | | Cancel | | Help 


图 15.5 信息 自动 填充 完整 


如 果 你 希望 以 后 都 不 用 再 输 keystore 的 密码 了 ， 可 以 将 Remember passwords 
选项 勾 上 。 然 后 点 击 Next， 这 时 束 要 选择 APK 文 件 的 输出 地 址 了 ， 如 图 15.6 
所 示 。 


二 
网 Generate Signed APK 


Note: Proguard settings are specified using the Project Structure Dialog 


APK Destination Folder: | \AndroidStudioprojects\CoolWeather | 六 | 


Build Type: | release 立 


Elavors: 


| Previous | | inish | | Cancel | | Help 


图 15.6 选择 APK 文 件 的 输出 地 址 


这 里 默认 是 将 APK 文 件 生成 到 项 目的 根 目录 下 ， 我 就 不 做 修改 了 。 现 在 点 
击 Finish， 然 后 稍 等 一 段 时 间 ， APK 文 件 就 都 会 生成 好 了 ， 并 且 会 在 右上 角 
弹出 一 个 如 图 15.7 所 示 的 提示 。 


全 Generate Signed APK 
APK(s) generated successfully. 
Show in Explorer 


图 15.7 提示 APK 文 件 生成 成 功 


我 们 点 击 提示 上 的 Show in Explorer 可 以 立刻 查看 生成 的 APK 文 件 ， 如 图 15.8 
所 示 。 


则 app 

hh build 

点 gradle 

上 国 .gitignore 

六 app-release.apk 
加 build.gradle 

| CoolWeatheriml 


| gradle.properties 


图 15.8 查看 生成 的 APK 文 件 


这 里 的 app-release.apk 束 是 帝 有 正式 签名 的 APK 文 件 了 。 


15.1.2 ”使 用 Gradle 生 成 


上 一 人 小节 中 我 们 使 用 了 Android Studio 提 供 的 可 视 化 工具 来 生成 带 有 正式 签 
名 的 APK 文 件 ， 除 此 之 外 ，Android Studio 其 实 还 提供 了 另外 一 种 方式 一 一 
使 用 Gradle 生 成 ， 下 面 我 们 就 来 学 习 一 下 。 


Gradle 是 一 个 非常 先进 的 项 目 构 建 工具 ， 在 Android Studio 中 开发 的 所 有 项 
目 都 是 使 用 它 来 构建 的 。 在 之 前 的 项 目 中 ， 我 们 也 体验 过 了 Gradle 带 来 的 很 
多 便利 之 处 ， 比 如 说 当 需 要 添加 依赖 库 的 时 候 不 需要 自己 再 去 手动 下 载 

了 ， 而 是 直接 在 dependencies 闷 包 中 添加 一 句 引 用 声明 束 可 以 了 。 


不 过 这 里 我 要 提醒 你 一 句 ， 如 果 你 想 将 Gradle 完 全 精通 的 话 ， 这 个 难度 就 比 
较 大 了 。Gradle 的 用 法 极为 丰富 ， 想 要 完全 掌握 它 的 用 法 ， 其 复杂 程度 并 不 
亚 于 学 习 一 门 新 的 语言 (Gradle 是 使 用 Groovy 语 言 编 写 的 ) 。 而 Android 中 
主要 只 是 使 用 Gradle 来 构建 项 目 而 已 ， 因 此 这 里 我 们 掌握 一 些 它 的 基本 用 法 
束 好 了 ， 重 点 还 是 要 放 在 功能 开发 上 面 ， 不 要 本 末 倒 置 了 了。 当然 ， 如 果 你 
对 Gradle 非 常 感 兴趣 ， 也 可 以 到 网 上 去 查询 它 的 更 多 用 法 。 


下 面 我 们 开始 学 习 如 何 使 用 Gradle 来 生成 带 有 正式 签名 的 APK 文 件 。 
app/build.gradle 文 件 ， 在 android 闭 包 中 添加 如 下 内 容 : 


编辑 


android { 
compilesdkVersion 24 
buildToolsVersion "24.0.2" 
defaultConfig { 
applicationId "com.coolweather.android" 
minSsdkVersion 15 
targetSsdkVersion 24 
versionCode 1 
versionName "1.0" 
} 
signingConfigs { 
config { 
storeFile file('C:/Users/Administrator/Documents/guolin.jks') 
StorePassword '1234567' 
keyAlias 'guolindev' 
keyPassword '1234567 
} 
buildTypes { 
release { 
minifyEnabled false 
proguardFiles getDefaultProguardFile('proguard-android.txt'), 
'proguard-rules.pro' 
} 
} 
} 


可 以 看 到 ， 这 里 在 android 闭 包 中 添加 了 一 个 signingConfigs 闭 包 ， 


signingConfigs 闭 包 中 人 了 一 个 config 闭 包 。 接 着 在 config 吉 包 中 本 
keystore 文 件 的 各 种 信息 ，storeFile 用 于 指定 keystore 文 件 的 位 置 ， 


storePassword 用 于 


别名 密码 。 


指定 密码 ，keyAlias 用 于 指定 别名 ， keyPassword 用 


将 签名 信息 都 配置 好 了 之 后 


用 这 个 配置 束 可 以 了 。 继续 编辑 app/build.gradle 文 件 ， 如 下 所 示 : 


android { 


buildTypes { 
release { 
minifyEna 
proguardF 
'prog 


signingCo 


bled false 

iles getDefaultProguardFile('proguard-android .txt' )， 
uard-rules.pro' 

nfig signingConfigs.config 


然后 在 


[ 置 
本 


| ie 


日 契 


接 下 来 只 需要 在 生成 正式 版 APK 的 时 候 去 应 


这 里 我 们 在 buildTypes 下 面 的 release 闭 包 中 应 用 了 刚才 添加 的 签名 配置 ， 这 
尝 当 生成 正式 版 APK 文 件 的 时 候 就 会 自动 使 用 我 们 刚才 配置 的 签名 信息 来 
进行 签名 了 。 


现在 build.gradle 文 件 已 经 配置 完成 ， 那 么 我 们 如 何 才能 生成 APK 文 件 呢 ? 其 
实 非常 简单 ，Android Studio 中 内 置 了 很 多 的 Gradle Tasks， 其 中 就 包括 了 生 
成 APK 文 件 的 Task。 点 击 右 侧 工具 栏 的 Gradle 一 项 目 名 

一 :app 一 Tasks 一 build， 如 图 15.9 所 示 。 


| Gradle projects 桨 "| 凡 
仿 十 一 他 三 至 攻 咏 | 车 2 
全 CoolWeather 


(© CoolWeather (root 
© :app 
Ea Tasks 
[Fa android 
[3 build 
党 assemble 
全 assembleAndroidTest 
党 assembleDebug 
党 assembleRelease 
党 build 
半 buildDependents 
上 buildNeeded 
全 clean 


图 15.9 查看 内 置 Gradle Tasks 


其 中 assembleDebug 用 于 生成 测试 版 的 APK 文 件 ，assembleRelease 用 于 生成 
正式 版 的 APK 文 件 ，assemble 用 于 同时 生成 测试 版 和 正式 版 的 APK 文 件 。 在 
生成 APK 之 前 ， 先 要 双击 clean 这 个 Task 来 清理 一 下 当前 项 目 ， 然 后 双击 
assembleRelease， 结 果 如 图 15.10 所 示 。 


| Run ® CoolWeather:app [assembleRelease] 


BUILD SUCCESSFUL 


Total time: 38. 048 secs 


«, 
呈 国 出 + ?+ 


14:13:17: External task execution finished ’assembleRelease’. 


防 4Run 人 衬 ToDo 党 和 AndroidMonitor 恩 9:Version Control 国 Terminal ”图 0: Messages 


图 15.10”assembleRelease 执 行 成 功 


可 以 看 到 ， 这 里 提示 我 们 BUILD SUCCESSFUL， 说 明 assembleRelease 执 行 
成 功 了 。APK 文 件 会 目 动 生成 在 app/build/outputs/apk 目 录 下 ， 如 图 15.11 所 
aN O 


‘ET project 引 日 丰 | 妾 " 引 | 
世 CoolWeather sers nistrata jro; 国 | 
DD .gradle 
四 .idea 
四 app 
四 build 
四 generated 
四 intermediates 
四 outputs 
四 apk 
天 app-release.apk 


上 日 app-release-unaligned.apk 


图 15.11 查看 生成 的 APK 文 件 


其 中 ，app-release.apk 就 是 带 有 正式 签名 的 APK 文 件 了 了 。 男 外 还 有 一 个 app- 
release-unaligned.apk， 这 是 一 个 没有 经 过 对 齐 的 正式 版 APK 文 件 ， 我 们 直接 
忽略 它 就 可 以 了 。 


虽说 现在 APK 文 件 已 经 成 功 生 成 了 ， 不 过 还 有 一 个 小 细节 需要 注意 一 下 。 
目前 keystore 文 件 的 所 有 信息 都 是 以 明文 的 形式 直接 配置 在 build.gradle 中 
的 ， 这 样 就 不 太 安全 。Android 推 荐 的 做 法 是 将 这 类 敏感 数据 配置 在 一 个 独 
立 的 文件 里 面 ， 然 后 再 在 build.gradle 中 去 读 取 这 些 数据 。 


下 面 我 们 来 按照 这 种 方式 实现 。Android Studio 项 目的 根 目 录 下 有 一 个 
gradle.properties 文 件 ， 它 是 专门 用 来 配置 全 局 键 值 对 数据 的 ， 我 们 在 
gradle.properties 文 件 中 添加 如 下 内 容 : 


KEY_PATH=C:/Users/Administrator/Documents/guolin.jks 


KEY_PASS=1234567 
ALIAS_ NAME=guolindev 
ALIAS_PASS=1234567 


可 以 看 到 ， 这 里 将 keystore 文 件 的 各 种 信息 以 键 值 对 的 形式 进行 了 配置 ， 然 
后 我 们 在 build.gradle 中 去 读 取 这 些 数 据 束 可 以 了 。 编 辑 app/build.gradle 文 
1 


android { 


signingConfigs { 
config { 
storeFile file(KEY_PATH) 
StorePassword KEY_PASS 
keyAlias ALIAS_NAME 
keyPassword ALIAS_PASS 


这 里 只 需要 将 原来 的 明文 配置 改 成 相应 的 键 值 ， 一 切 就 完工 [。 这 样 直 接 
查看 build.gradle 文 件 是 无 法 看 到 keystore 文 件 的 各 种 信息 的 ， 只 有 查看 
gradle.properties 文 件 才能 看 得 到 。 然 后 我 们 只 需要 将 gradle.properties 文 件 保 
护 好 束 行 了 ， 比 如 说 将 它 从 Git 版 本 控制 中 排除 。 这 样 gradle.properties 文 件 
束 只 会 保留 在 本 地 ， 从 而 也 束 不 用 担心 keystore 文 件 的 信息 会 泄漏 了 了。 


15.1.3 ”生成 多 渠道 APK 文 件 


现在 你 已 经 掌握 了 两 种 生成 带 有 正式 签名 的 APK 文 件 的 方式 ， 从 简易 程度 
和 式 才 不 多 ， 基 本 都 还 是 比较 答 单 的 ， 选 择 使 用 哪 一 种 全 和 插 
尔 目 己 的 喜好 。 


现在 APK 文 件 已 经 生成 好 了 ， 可 能 在 大 多 数 情况 下 ， 我 们 都 只 需要 一 个 
APK 文 件 就 足够 了 ， 不 过 本 小 节 中 我 们 再 来 讨论 一 种 比较 特殊 的 情况 一 一 
生成 多 渠道 APK 文 件 。 


在 本 章 的 开头 就 已 经 提 到 过 ， 目 前 Android 领 域 的 应 用 商店 非常 多 ， 不 像 苹 
果 只 有 一 个 App Store。 当 然 我 们 完全 可 以 使 用 同一 个 APK 文 件 来 上 架 不 同 
的 应 用 商店 ， 但 是 如 果 你 有 一 些 特殊 需求 的 话 ， 比 如 说 针对 不 同 的 应 用 商 
店 渠道 来 定制 不 同 的 界面 ， 这 就 比较 头疼 了 。 

传统 情况 下 ， 开 发 这 种 差异 性 需求 非常 痛苦 ， 通 常 需要 维护 多 份 代码 版 
本 ， 然 后 逐个 打 成 相 应 渠道 的 APK 文 件 。 一 旦 有 任何 功能 变更 就 苦 不 堪 
言 ， 因 为 每 份 代码 版 本 里 面 都 需要 逐个 修改 一 遍 。 


圣 运 的 是 ， 现 在 Android Studio 提 供 了 一 种 非常 方便 的 方法 来 应 对 这 种 差异 
性 需求 ， 极 大 程度 地 解决 了 之 前 版 本 维护 困难 的 问题 ， 下 面 我 们 就 来 学 习 
人 

比如 说 这 里 我 们 准备 生成 360 和 百度 两 个 渠道 的 APK 文 件 ， 那 么 修改 
app/build.gradle 文 件 ， 如 下 所 示 : 


android { 

CompileSdkVversion 24 

buildToolsVersion "24.0.2" 

defaultConfig { 
applicationId "com.coolweather.android" 
minSsdkVersion 15 
targetSsdkVersion 24 
versionCode 1 
versionName "1.0" 


productFlavors { 
qihoo { 


applicationId "com.coolweather.android.qihoo" 


baidu { 
applicationId "com.coolweather.android.baidu" 


可 以 看 到 ， 这 里 添加 了 一 个 productFlavors 闭 包 ， 然 后 在 该 闭 包 中 添加 所 
有 的 渠道 配置 就 可 以 了 。 注 意 Gradle 中 的 配置 规定 不 能 以 数字 开头 ， 因 此 这 
里 我 将 360 的 渠道 名 配置 成 了 qihoo。 渠 道 名 的 财 包 中 可 以 履 写 defaultConfig 
中 的 任何 一 个 属性 ， 比如 说 这 里 将 applicationId 属性 进行 了 履 写 ， 那么 最 
终生 成 的 各 渠道 APK 文 件 的 包 名 也 将 各 不 相同 。 


接 下 来 我 们 开始 针对 不 同 渠 道 编 写 差 异性 需求 。 在 app/src 目 录 下 《main 的 
平 级 目录 ) 新 建 一 个 baidu 目 录 ， 然 后 在 baidu 目 录 下 再 新 建 java 和 res 这 两 个 


目录 ， 如 图 15.12 所 示 。 


BB project ”| 人 @ 直 | 党- 
世 CoolWeather | 
请 .gradle 
四 .idea 
加 app 
四 build 
户 libs 
户 src 
四 androidTest 
四 baidu 
四 java 
Ea res 
四 main 
DD test 


图 15.12 创建 渠道 专属 目录 

这 样 我 们 就 可 以 在 这 里 编写 百度 渠道 特有 的 功能 了 ，java 目 录用 于 存放 代 
码 ，res 目 了 永 用 于 存放 资源 ， 如 果 需 要 履 写 AndroidManifest 文 件 中 的 内 容 ， 
还 可 以 在 baidu 目 隶 下 再 新 建 一 个 AndroidManifest,xml 文 件 。 


当然 ， 实 际 上 我 们 并 没有 什么 渠道 差异 性 的 需求 ， 因 此 这 里 也 只 是 为 了 演 
示 一 下 ， 我 们 区 给 不 同 渠 道 的 APK 起 一 个 不 同 的 应 用 名 吧 。 


二 1: Project 


e? 7: Structure 


Captures 


应 用 名 之 前 是 定义 在 main/res/values/string.xml 文 件 中 的 ， 那 么 我 们 在 baidu 目 
录 下 也 建立 一 个 相同 的 目录 结构 ， 然 后 将 baidw/res/values/string.xml 中 的 内 容 
进行 如 下 修改 : 


<resources> 
<string name="app_name"> 酪 欧 百度 版 </string> 
</resources> 


这 样 百 度 渠 道 的 APK 就 会 使 用 baidures/values/string.xml 中 定义 的 应 用 名 来 覆 
盖 原 有 的 应 用 名 。 同 样 的 道理 ， 我 们 再 新 建 一 个 qihoo 目 录 ， 然 后 在 qihoo 目 
录 下 也 建立 相同 的 日 录 结 构 ， 并 将 string.xml 中 的 内 容 进 行 如 下 修改 : 


<string name="app_name"> 酷 欧 360 版 </string> 
</resources> 


这 样 我 们 就 以 一 个 简单 的 示例 实现 渠道 差异 性 需求 了 ， 下 面 开始 来 生成 多 
渠道 的 APK 文 件 。 观 察 右 侧 工 具 栏 的 Gradle Tasks 列 表 ， 你 会 发 现 里 面 多 出 
了 几 个 新 的 Task， 如 图 15.13 所 示 。 


| Gradle projects | 
+ 一 避 瑟 主 吕 | 小 | 隔 
| 全 CoolWeather 
(© CoolWeather (root) 
© :app 
Ca Tasks 
Fa android 
Ca build 
地 assemble 
全 assembleAndroidTest 
党 assembleBaidu 
六 assembleDebug 
六 assembleQihoo 
全 assembleRelease 
build 
全 buildDependents 
全 buildNeeded 
全 clean 


图 15.13 查看 新 的 Task 


其 中 ， 如 果 你 只 想 生 成 百度 渠道 的 APK 文 件 ， 那 么 就 执行 assembleBaidu 
如 果 你 只 想 生成 360 渠 道 鸭 APK 文 件 ， 那 么 丈 执 行 assembleQihoo; 如 有 果 你 想 
一 次 性 生成 所 有 渠道 的 APK 文 件 ， 那 么 就 还 是 执行 assembleRelease。 


除了 使 用 Gradle 的 方式 生成 之 外 ， 使 用 Android Studio 提 供 的 可 视 化 工具 也 
是 能 生成 多 渠道 APK 文 件 的 ， 如 图 15.14 所 示 。 


隔 
网 Generate Signed APK 


Note: Proguard settings are specified using the Project Structure Dialog 
APK Destination Folder: | \AndroidStudioProjects\CoolWeather | 权 | 


Build Type: | release 加 
Elovoree [CS 
qihoo 


| Brevious | Finish | Cancel | | Help 


图 15.14 使 用 可 视 化 工具 生成 多 渠道 APK 


这 里 我 们 可 以 选择 是 生成 百度 渠道 的 APK 文 件 ， 还 是 生成 360 渠 道 的 APK 文 
如 果 你 想 一 次 性 生成 多 个 渠道 的 APK 文 件 ， 按 住 CTRL 键 就 可 以 进行 多 
Es 


接 下 来 我 们 可 以 通过 adb install 命令 将 生成 好 的 APK 文 件 安装 到 模拟 器 
上 ， 如 图 15.15 所 示 。 


Microsoft Windows ESTEE2T7TE 
版 权 所 有 《c> 20099 Microsoft Cokpokation。 保留 所 有 权利 。 


C:NVUsers\nhdministhatokr>adhb install CGC:\sers dnmninistrator MAndroidSstudioProjects 
TT .apk 


图 15.15 将 生成 的 APK 安 装 到 模拟 器 上 


adb install 命令 的 后 面 加 上 APK 文 件 的 路 径 ， 就 可 以 将 该 APK 文 件 安装 到 
模拟 器 和 360 这 两 个 渠道 的 APK 文 件 都 安 
装 到 模拟 器 上 ， 结 果 如 图 15.16 所 示 。 


QUOD 


千 欧 百度 版 


图 15.16 模拟 器 上 的 安装 结果 


可 以 看 到 ， 目 前 模拟 器 上 有 3 个 版 本 的 酷 欧 天 气 ， 这 是 由 于 之 前 我 们 在 
productFlavors 中 和 窗 写 了 各 渠道 的 applicationId 属性 ， 保 证 每 个 APK 文 件 的 
包 名 都 不 相同 ， 因 而 它们 才能 安装 到 同一 个 设备 上 面 。 男 外 ， 从 应 用 名 上 
来 看 ， 渠 道 差 异性 开发 工作 也 顺利 完成 了 。 


不 过 ， 上 面 的 例子 只 是 为 了 演示 生成 多 渠道 APK 功 能 而 特意 编写 的 ， 实 际 
上 我 们 并 没有 这 个 需求 。 现 在 将 productFlavors 闭 包 删除 ， 恢 复 成 之 前 的 
APK 文 件 ， 我 们 准备 进行 上 架 操 作 。 


15.2 ”申请 360 开 发 者 账号 


目前 ， 酷 欧 天 气 的 APK 安 装 包 已 经 准备 好 了 ， 但 如 果 想 要 把 它 发 布 到 360 应 
用 商店 ， 还 需要 去 申请 一 个 360 开 发 者 账号 才 行 ， 申 请 地 址 是 : 
http://dev.360.cn ° 


打开 该 网 页 ， 在 页 面 顶 部 有 登录 和 注册 按钮 。 如 果 你 还 没有 360 账 号 ， 则 需 
要 在 这 里 注册 一 个 新 的 账号 ， 如 果 你 之 前 已 经 有 360 账 号 了 ， 那 么 直接 登录 
就 可 以 了 。 


登录 成 功 之 后 打开 http://dev.360.cn/mod/developer 这 个 网 址 ， 来 申请 成 为 开 
发 者 ， 如 图 15.17 所 示 。 


请 选择 注册 开发 者 类 型 


图 15.17 选择 注册 开发 者 类 型 


这 里 可 以 选择 是 申请 成 为 个 人 开发 者 还 是 企业 开发 者 。 很 显然 ， 我 们 是 以 
个 人 的 身份 来 发 布 应 用 的 ， 那 么 点 击 个 人 开发 者 就 可 以 了 。 


接 下 来 需要 填写 一 些 基 本 信息 和 联系 方式 ， 如 图 15.18 所 示 。 


| 基本 信息 


注册 屿 号 : sinyu890807@126.com 


开发 者 姓 三 : 
出 晶 人 
上 传 证 件 昭 : 
查看 示例 
个 人 身份 证 件 : 护照 


图 15.18 ” 填 基 本 信息 和 联系 方式 


填写 完 基本 信息 之 后 辣 下 深 动 继续 填写 联系 方式 ， 全 部 填写 完成 之 后 ， 扩 
击 屏幕 最 下 方 的 “同意 并 注册 开发 者 ”按钮 来 完成 注册 ， 如 图 15.19 所 示 。 


避 我 已 阅读 并 同意 《360 移 动 开 放 平 人 台 服 务 条 款 》 


同意 并 注册 开 友 者 


图 15.19 ”完成 开发 者 注册 
这 样 你 就 成 功 成 为 一 名 360 开 发 者 了 ! 


15.3 ”发 布 应 用 程序 


接 下 来 我 们 开始 发 布 酷 欧 天 气 这 个 应 用 ， 还 是 在 浏览 器 访问 地 址 : 
http://dev.360.cn ， 你 会 在 界面 上 看 到 如 图 15.20 所 示 的 内 容 。 


OO OO 


图 15.20 软件 发 布 和 游戏 发 布 
然后 点 击 软件 发 布 ， 就 会 显示 如 图 15.21 所 示 的 界面 。 


请 选择 软件 类 型 
发 布 软件 类 应 用 , 如 : 新 闻 类 应 用 ， 购 物 类 应 用 发 布 电子 书 应 用 ， 如 : 单 本 小 说 、 杂 志 、 漫 画 等 


图 15.21 选择 软件 类 型 


我 们 需要 选择 是 发 布 软件 类 应 用 还 是 电子 书 类 应 用 ， 这 里 点 击 软件 。 接 下 
来 会 弹出 一 个 新 的 界面 让 我 们 上 传 APK 以 及 填写 应 用 信息 。 首 先 来 上 传 
APK 吧 ， 点 击 上 传 按钮 ， 选 择 带 有 正式 签名 的 APK 文 件 ， 然 后 就 会 自动 开 
始 上 传 了 ， 上 传 完成 之 后 会 显示 如 图 15.22 所 示 的 界面 。 


酷 欧 天 气 
包 和 名 : com.coolweather.android 
版 本 名 称 : 1.1 
版 本 号 : 2 
安全 系数 您 的 应 用 安全 系数 未 达标 ! 加 国 
/小 次 和 保 户 安 ES 
可 减少 盗版 和 破解 ， 保障 用 户 安 立即 加 固 
0 全 使 用 。 
分 


图 15.22 上传 APK 完 成 


这 个 界面 提醒 我 们 ， 目 前 应 用 的 安全 系数 较 低 ， 建 议 对 APK 进 行 加 固 。 实 
际 上 这 个 是 360 应 用 商店 的 特殊 需求 ， 并 不 是 所 有 应 用 商店 都 要 求 进行 加 固 
的 。 但 是 我 们 还 是 得 按照 它 的 要 求 来 修改 ， 不 然 审核 可 能 会 不 通过 。 


这 里 点 击 立 即 加 固 按 钮 ，360 会 帮忙 我 们 将 原 APK 文 件 进行 加 固 ， 并 生成 一 
个 狐 的 APK 文 件 ， 如 图 15.23 所 示 。 


加 国 成 功 ， 请 下 载 后 重新 签名 ， 再 次 提交 审核 。 下 载 应 用 
温 声 提示 : 

1. 您 以 后 的 更 新 包 可 以 到 360 加 国保 加 国 并 签 和 名 ， 再 上 传 平 台 室 核 

2, 使 用 360 加 固 助 手 ， 一 链 完 成 应 用 加 国 ,签名 , 打 湛 请 包 .发 布 市 场 等 择 作 。 立即 
下 载 


图 15.23 ”加固 成 功 提示 


不 过 这 个 加 固 后 的 APK 文 件 是 没有 经 过 签名 的 ， 也 束 是 说 我 们 还 需要 将 它 
下 载 下 来 ， 然 后 手动 进行 等 名 才 行 。 


点 击 下 载 应 用 按钮 ， 先 将 加 固 后 的 APK 文 件 下 载 下 来 。 接 下 来 的 工作 就 有 
点 烦琐 了 ， 因 为 Android Studio 中 并 没有 提供 对 一 个 未 签名 的 APK 直 接 进行 
签名 的 功能 ， 因 此 我 们 只 能 通过 最 原始 的 方式 ， 使 用 jarsigner 命令 来 进行 


在 命令 行 界 面 按照 以 下 格式 输入 等 名 命令 : 


jarsigner -verbose -sigalg SHA1withRSA -digestalg SHA1 -keystore [keystore 文 件 路 径 ] - 
storepass [keystore 文 件 密码 ] [ 竺 签名 APK 路 径 ] [keystore 文 件 别名 ] 


将 [] 中 的 描述 蔡 换 成 keystore 文 件 的 具体 信息 就 能 签名 成 功 了 ， 注 意 [] 符号 
征 不 需要 的 。 接 着 我 们 将 签名 后 的 APK 文 件 重新 上 传 就 可 以 了 。 


APK 上 传 成 功 之 后 ， 接 下 来 需要 选择 应 用 的 分 类 ， 如 图 15.24 所 示 。 


分 类 : 立 用 工具 


H 
川 
人 


上 传 版 权证 明 ( 选 填 ) : 


版 权证 明 是 什么 ? 软 著 快速 申请 


图 15.24 选择 应 用 分 类 


这 里 我 们 将 应 用 分 类 选择 成 实用 工具 天气。 下 面 还 有 一 个 上 传 版 权证 明 
的 选项 ， 这 是 一 个 选 二 项， 我们 直接 忽略 束 可 以 了 。 


接着 同 下 深 动 网 页 ， 设 置 支 持 的 语言 以 及 资费 类 型 ， 如 图 15.25 所 示 。 


支持 语言 : ”简体 中 文 " © 
资费 类 型 : ”免费 软件 ' © 


图 15.25 设置 支持 语言 和 资费 类 型 


继续 深 动 网 页 ， 下 面 需 要 填写 应 用 简介 以 及 当前 版 本 介绍 ， 如 图 15.26 所 
示 “。 


应 用 简介 : ” 酷 欧 天 气 是 一 款 基于 Android 端 开源 的 天 气 预 报 软件 ， 县 备查 看 © 
全 国 的 省 市 县 、 坦 询 任意 城市 天 气 、 自 由 切换 城市 、 手 动 更 新 天 
气 、 后 台 自 动 更 新 天 气 等 功能 。 酮 欧 天 气 中 的 天 气 数据 由 和 风 天 
气 捉 供 ， 背 景 图 片 由 必 应 提供 ， 代 码 遵循 Apache v2 License 开 源 
协议 。 本 软件 主要 作为 学 习 和 交流 使 用 。 


50-1500 字 ， 请 向 用 户 介 绍 一 下 你 的 应 用 。 


当前 版 本 介绍 : ” 酷 欧 天 气 是 一 款 基 于 Android 端 开源 的 天 气 预报 软件 ,县 备查 看 。 人 @ 
全 国 的 省 市 县 、 查 询 任意 城市 天 气 、 自 由 切换 城市 、 手 动 更 新 天 
气 、 后 台 自 动 更 新 天 气 等 功能 。 


50-400 字 符 ， 请 回 用 户 介绍 当前 应 用 版 本 及 更 新 内 容 。 


图 15.26 填写 应 用 简介 和 当前 版 本 介绍 


在 版 本 介绍 的 下 面 ，360 还 有 要求 填写 一 项 隐私 权限 说 明 ， 由 于 酷 欧 天 气 只 申 
请 了 一 个 网 络 权限 ， 因 此 没什么 需要 说 明 的 ， 我 们 直接 名 略 这 一 项 就 可 以 
re 


继续 向 下 滚动 网 页 ， 接 下 来 需要 上 传 一 张 高 分 辨 率 的 应 用 图 标 ， 图 标 要 求 
是 512x512 像 素 的 PNG 格 式 图 片 ， 如 图 15.27 所 示 。 


应 用 图 标 : 要求 与 去 装 包 中 图 标 一 致 。 尺 寸 : 512*512FX， 圆 角 夺 径 弧 度 : 70PX， 图片 格式 : PNG 


图 15.27 上传 高 分 辨 率 的 应 用 图 标 


上 传 好 了 图 标 ， 我 们 还 需要 提供 5 张 酷 欧 天 气 的 屏幕 截图 ， 点 击 上 传 截图 按 
钮 ， 然 后 选择 准备 好 的 图 片 即 可 ， 如 图 15.28 所 示 。 


应 用 截图 : 请 


图 15.28 上传 屏幕 截图 


继续 癌 下 滚动 ， 还 有 一 个 审核 辅助 说 明 的 选 填 项 ， 我 们 也 直接 忽略 就 可 以 
了 。 最 后 束 是 一 些 额 外 的 定制 选项 ， 如 图 15.29 所 示 。 


是 否 进行 云 测 试 : 是 外 百 


Testin 云 测 


发 布 时 间 : ”和 市 核 后 立即 发 布 中 定时 发 布 


图 15.29 额外 的 辅助 选项 
这 里 我 们 选择 不 进行 云 测 试 ， 并 在 审核 后 立即 发 布 。 


激动 人 心 的 时 刻 终 于 到 了 ， 现 在 点 击 一 下 提交 审核 按钮 就 可 以 将 酷 欧 天 气 
发 布 到 360 应 用 商店 了 ， 这 时 会 显示 如 图 15.30 所 示 的 提示 。 
我 们 将 在 一 个 工作 日 内 完成 审核 ， 通 过 邮件 和 短信 告知 结果 ， 请 注意 查收 。 


YY om 


图 15.30 ”提交 成 功 提示 


由 于 360 会 对 我 们 的 应 用 程序 进行 审核 ， 接 下 来 又 进入 了 等 待 当中 。 不 过 还 
好 ， 根 据 提 示 来 看 ， 这 次 也 许 不 需要 等 太 久 。 


果不其然 ， 过 了 几 个 小 时 之 后 在 360 手 机 助手 上 搜索 酪 欧 天 气 天 键 子 ， 束 可 
以 看 到 这 个 应 用 已 经 成 功 上 线 了 ， 如 图 15.31 所 示 。 


提交 成 功 ! 


A 15:18 


图 15.31 搜索 酷 欧 天 气 关键 字 
点击 进去 可 以 查看 应 用 的 详情 ， 如 图 15.32 所 示 。 


国 安全 系数 9 多 弗 vE: 


[实用 工具 | 酷 欧 天 气 是 一 款 基 于 Android 端 开源 的 天 气 
预报 软件 ， 具 备查 看 全 国 的 省 市 县 、 查 询 任 意 城市 天 


用 户 评价 现 要 评 放 


图 15.32 查看 应 用 详情 


到 了 这 里 ， 我 们 就 将 应 用 程序 的 发 布 工作 全 部 完成 了 ， 之 后 你 应 该 尽 可 能 
地 多 为 你 的 应 用 进行 宣传 ， 因 为 用 户 越 多 ， 你 能 得 到 的 回报 就 越 大 。 那 么 
如 何 才 能 从 我 们 六 圣 藻 东 编写 的 程序 中 得 到 回报 呢 ? 方式 有 很 多 种 ， 其 中 
较为 第 见 的 做 法 束 古 通过 广告 来 进行 僵 利 ， 因 此 下 一 市 我 们 就 学 习 一 下 ， 
如 何在 应 用 程序 中 藤 入 广告 。 


15.4” 航 入 广告 进行 僵 利 


谷歌 充分 考虑 到 了 可 以 在 Android 应 用 程序 中 网 入 广告 来 让 开发 者 获得 收 
入 ， 因 此 早早 地 就 收购 了 AdMob 公 司 。AdMob 创 立 于 2006 年 ， 是 全 球 最 早 
致力 于 在 移动 设备 上 提供 广告 服务 的 公司 之 一 ， 如 今 成 为 了 谷歌 的 子 公 
司 ，AdMob 的 广告 更 加 适合 在 Android 系 统 以 及 Google Play 上 面 进行 投放 。 


不 过 对 于 国内 开发 者 来 说 ，AdMob 可 能 吏 不 是 那么 适合 了 。 因 为 AdMob 平 
台 上 的 广告 大 多 都 是 英文 的 ， 中 文 广告 数 有 限 ， 并 且 将 AdMob 账 尸 中 的 钱 
提取 到 银行 账户 中 也 比较 麻烦 ， 因 此 这 里 我 们 就 不 准备 使 用 AdMob 了 ， 而 
征 将 眼光 放 在 一 些 国内 的 移动 广告 平台 上 面 。 在 国内 的 这 一 领域 ， 做 得 比 
较 好 的 移动 广告 平台 也 不 少 ， 其 中 我 个 人 认为 腾讯 广告 联盟 ( 原 广 点 通 ) 
特别 专业 ， 因 此 我 们 惑 选择 它 来 为 酷 欧 天 气 提 供 广告 服务 吧 。 


15.4.1 注册 腾讯 广告 联盟 账号 


下 面 开 始 动手 ， 首 先 第 一 步 我 们 需要 注册 一 个 腾讯 广告 联盟 的 账号 ， 注 册 
地 址 为 : http://e.qq.com/dev/index.html] 。 


打开 该 网 页 ， 选 择 使 用 QQ 号 登录 ， 然 后 就 会 自动 跳 转 到 腾讯 广告 联盟 的 注 
册 界 面 ， 如 图 15.33 所 示 。 图 15.33 中 的 所 有 内 容 都 是 必 填 项 ， 我 们 按照 实际 
情况 来 填写 就 可 以 了 ， 填 写 完成 之 后 点 击 下 一 步 ， 如 图 15.34 所 示 。 


会 员 类 型 : | 个 人 赤 请 选择 正确 的 会 员 类 型 ， 天 则 无 法 获取 收益 


身份 证 号 码 : 


联系 地 址 : 


手机 号 码 : 


电子 邮箱 : 


电子 邮箱 验证 码 : 


注册 来 源 : yy 


图 15.33 填写 个 人 信息 


收 款 方 : | 郭 每 


开户 银行 : ”请 选择 > 
开户 行 所 在 地 : “北京 市 | 东城 到 
支行 名 称 : 
银行 账号 : 
账号 确认 : 


支持 格式 仅 限 jpg,png, 大 小 2M 以 内 
选择 文件 | 未 选择 任何 文件 


图 15.34 填写 银行 卡 信 息 


由 于 腾讯 广告 联盟 涉及 提现 服务 ， 因 此 我 们 还 需要 填写 银行 卡 信息 ， 并 上 
传 银行 卡 照 片 。 填 写 完 成 之 后 继续 点 击 下 一 步 ， 如 图 15.35 所 示 。 


银行 卡 正面 照片 : 


身份 证 正面 照片 : | 选择 文件 | 未 选择 任何 文件 


身份 证 反面 照片 : | 选择 文件 | 未 选择 任何 文件 


支持 格式 仅 限 jpg,png, 太 小 2M 以 内 
w 同意 《腾讯 广 点 通 移 动 联盟 开发 者 协议 > 


图 15.35 上 传 身份 证 照片 


最 后 ， 将 你 的 身份 证 正 反 面 照片 上 传 ， 点 击 提交 按钮 ， 就 能 提交 审核 了 ， 
如 图 15.36 所 示 。 


您 的 会 员 注册 已 提交 成 功 ， 我 们 会 在 1 个 工作 日 内 完成 审核 ， 请 耐心 等 待 。 


图 15.36 提交 审核 


只 要 你 前 面 填 写 的 内 容 都 是 真实 有 效 的 ， 审 核 一 般 都 会 很 快 通过 ， 这 里 我 
们 只 需要 耐心 等 待 几 个 小 时 就 好 了 。 


15.4.2 新建 媒 体 和 广告 位 


审核 通过 之 后 ， 我 们 就 可 以 进入 到 腾讯 广告 联盟 的 后 台 ， 开 始 给 酷 欧 天 和 气 
添加 广告 了 。 首 先 需 要 进入 媒体 管理 界面 ， 点 击 新 建 媒 体 按钮 ， 这 时 会 显 
示 一 个 页 面 来 让 你 填写 应 用 的 相关 信息 ， 我 们 根据 提示 一 一 填 好 即 可 ， 如 
图 15.37 所 示 。 


系统 平台 : @ /请 | android 程 序 令 osaF 
媒体 名 称 : 酷 欧 天 气 

关键 词 : 天 气 

媒体 类 别 : 生活 实用 EE 


酷 欧 天 气 是 一 款 基于 sndroid 端 开源 的 天 气 预 报 软 | 
件 ， 具 备查 看 全 国 的 省 市 县 、 查 询 任意 城市 天 气 、 

自由 切换 城市 、 手 动 更 新 天 气 、 后 全 自动 更 新 天 所 
等 功能 


媒体 漳 介 : 
4 
程序 主 包 名 : com.coolweather.android 
媒体 状态 : 和 ”已 上 架 未 上 架 
详情 页 地 址 : http://zhushou.360.cn/detail/index/sof 


图 15.37 填写 应 用 的 相关 信息 

注意 这 里 需要 填写 一 个 详情 页 地 址 ， 也 就 是 酷 欧 天 气 在 360 应 用 商店 上 的 详 
情 页 地 址 。 打 开 http://zhushou.360.cn ， 在 搜索 框 上 输入 “ 栈 欧 天 气 ”"， 就 能 找 
到 该 地 址 了 。 


填写 完成 之 后 点 击 下 一 步 ， 接 下 来 需要 下 载 SDK， 如 图 15.38 所 示 。 


媒体 名 称 : 酷 欧 天 气 
媒体 类 型 : | 重 ， Andriod 程 序 


应 用 ID : 1105585573 


' 虱 Andriod SDK 下 载 


图 15.38 下 载 SDK 


点 击 Android SDK 下 载 按 钮 ， 先 把 SDK 下 载 下 来 ， 我 们 稍 后 就 会 进行 接 入 。 
继续 点 击 下 一 步 ， 如 图 15.39 所 示 。 


媒体 名 称 : 酷 欧 天 气 

媒体 类 型 : | 重 ， Andriod 程 序 

应 用 ID : 1105585573 

应 用 程序 : 上 传 “外 输入 下 载 URL 
| htp://zhushou.360.cn/detail 


上 一 步 


图 15.39 ”完成 媒体 创建 


这 里 要 求 填 入 一 个 APK 的 下 载 的 地 址 ， 我 们 直接 束 填 入 图 15.37 当 中 的 详情 
页 地 址 就 可 以 了 。 点 击 完 成 按钮 ， 现 在 又 会 进入 到 审核 等 待 当中 。 


为 什么 新 建 媒体 也 需要 进行 审核 呢 ? 这 是 因为 腾讯 为 了 防止 某 些 开 发 者 在 
垃圾 软件 上 面 投放 广告 ， 因 此 要 求 开 发 者 必须 提交 应 用 程序 的 APK 文 件 进 
行 审核 ， 只 有 审核 通过 的 应 用 才 人 允许 进行 广告 投放 。 那 么 我 们 只 能 继续 等 
待 。 审 核 通 过 之 后 ， 在 媒体 管理 界面 查看 新 建 媒体 的 状态 ， 如 图 15.40 所 
示 “。 


应 用 ID 媒体 名 称 ” ”联盟 开通 状态 。 ”业务 状态 系统 平台 探 作 


1105585573 酪 欧 天 气 已 开通 正常 Android 修改 新 建 广告 位 


图 15.40 ”查看 新 建 媒体 的 状态 

可 以 看 到 ， 联 盟 开通 状态 显示 已 开通 ， 业 务 状态 显示 正常 ， 说 明 新 建 的 媒 
体 已 经 通过 审核 了 。 注 意 这 里 还 自动 生成 了 一 个 应 用 ID， 我 们 稍 后 就 会 用 
到 。 


现在 点 击 痢 建 广告 位 ， 就 可 以 来 创建 一 个 广告 位 了 ， 如 图 15.41 所 示 。 


新 建 广告 位 X 


媒体 选择 : 酷 欧 天 气 


广告 位 名 称 : 启动 广告 
广告 位 类 型 : Banner 广 告 应 用 墙 插 屏 广告 “看 开 屏 广告 


YY 成 人 用 品类 
”医疗 科室 类 
减肥 类 
屏蔽 行业 : 心理 健康 类 
星座 算命 类 
YP2P 了 网 贷 平 台 
如 果 对 于 某 些 类 型 的 广告 素材 (例如 成 人 人 用品) 过 于 敏感 ， 您 可 以 进行 行业 广告 屏蔽 


图 15.41 新 建 广告 位 


首先 要 输入 广告 位 的 名 称 ， 然 后 选择 广告 位 的 类 型 。 腾 讯 广告 联 盟 文 持 
Banner、 应 用 墙 、 搬 屏 和 开 屏 这 4 种 广告 类 型 ,具体 每 种 广告 类 型 的 区 别 你 
可 以 通过 得 阅 文 档 进行 了 解 ， 这 里 我 们 选择 开 屏 广告 。 接 下 来 还 可 以 对 一 
= 告 进行 屏蔽 ， 选 择 完成 之 后 点 击 创建 按钮 完成 广告 位 创 
建 。 


现在 进入 到 广告 位 管理 界面 ， 就 能 查看 到 我 们 刚刚 新 建 的 广告 位 了 ， 如 图 
15.42 所 示 。 


名 称 &ID 广告 位 类 型 所 属 应 用 &ID 业务 状态 广告 位 状态 探 作 


启动 广告 酷 欧 天 气 os 
开 屏 正常 领 ) 启用 中 修改 
4010212448179536 1105585573 


图 15.42 查看 新 建 广 告 位 


其 中 ，4010212448179536 是 广告 位 ID，1105585573 是 应 用 ID。 有 了 这 两 个 
数据 之 后 ， 我 们 就 可 以 开始 接 入 广告 SDK 了 。 


15.4.3” 接 入 广告 SDK 


ne 里 面 的 内 容 非 营 简单， 如 图 15.43 
Nas 


称 


将 


DD resources 

@ GDT DEV guide.4.9.html 

国 GDTUnionDemo.zip 

攻 | GDTUnionSDK.4.9.533.minjar 


图 15.43 “广告 SDK 压 缩 包 中 的 内 容 


其 中 resources 文 件 夹 中 放 的 是 一 些 资源 图 片 ， 我 们 使 用 不 到 。GDT DEV 
guide.4.9.html 是 广告 SDK 的 对 接 文档 ，GDTUnionDemo.zip 是 广告 SDK 的 对 
接 示例 ，GDTUnionSDK.4.9.533.min.jar 则 是 广告 SDK 中 最 主要 的 一 个 Jar 包 
文件 了 。 


由 于 腾讯 广告 SDK 中 的 功能 还 是 挺 多 的 ， 这 里 不 可 能 面面俱到 ， 将 每 一 个 
功能 都 进行 详细 地 讲解 。 因 此 我 准备 只 讲解 开 屏 广告 这 一 种 类 型 的 广告 用 
法 ， 剩 下 的 其 他 功能 你 可 以 通过 阅读 文档 来 进行 学 习 。 


我 们 先 将 GDTUnionSDK.4.9.533.min.jar 复 制 到 appylibs 目 录 当 中 ， 并 点 击 一 
下 Android Studio 顶 部 工具 栏 中 的 Sync 按钮 完成 同步 。 


接着 在 AndroidManifest,xml 中 声明 以 下 权限 ， 其 中 网 络 访问 权限 是 之 前 声明 
过 的 ， 不 需要 声明 两 迄 。 


-permission android:name="android.permission.INTERNET" /> 

-permission android:name="android.permission.ACCESS_ NETWORK_STATE" /> 
-permission android:name="android.permission.ACCESS WIFI_STATE" /> 
-permission android:name="android.permission.READ_ PHONE_STATE" /> 
-permission android:name="android.permission.ACCESS_ COARSE_LOCATION" /> 


-permission android:name="android.permission.ACCESS_ COARSE_UPDATES" /> 
-permission android:name="android.permission.WRITE_ EXTERNAL_STORAGE" /> 


We 


壮 局 3 其 中 READ_PHONE_STATE 、 ACCESS_COARSE_LOCATION 和 
WRITE_EXTERNAL_STORAGE 这 3 个 权限 是 危险 权限 ， 因 此 我 们 竺 会 还 需要 进行 
运行 时 权限 处 理 。 


接 下 来 在 <application> 标签 中 添加 如 下 内 容 : 


<activity 
android:name="com.qq.e.ads.ADActivity" 
android:configChanges="keyboard|keyboardHidden|orientation|screenSize" /> 
<service 
android:name="com.qq.e.comm.DownloadService" 
android:exported="false" /> 


这 样 就 将 配置 工作 完成 了 。 


然后 我 们 还 需要 创建 一 个 用 于 显示 开 屏 广告 的 活动 ， 右 击 
com.coolweather.android 包 ~ New 一 Activity Empty Activity， 创 建 一 个 
SplashActivity， 并 将 布局 名 指定 成 activity_splash.xml。 修 改 
activity_splash.xml 中 的 代码 ， 如 下 所 示 : 


<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/container" 
android:layout_width="match_parent" 
android:layout_height="match_parent"> 


</Relat 


iveLayout> 


只 有 一 个 空 的 RelativeLayout， 我 们 并 不 需要 在 RelativeLayout 当 中 放 入 
什么 内 容 ， 但 是 必须 给 它 定 义 一 个 id。 


接着 修改 SplashActivity 中 的 代码 ， 如 下 所 示 : 


public 


pri 


ihe 


大 
ph 
pri 


Q@OvV 
pro 


pri 


class SplashActivity extends AppCompatActivity { 


vate RelativeLayout container,; 


于 判断 是 否 可 以 跳 过 广告 ， 进 入 MainActivity 
vate boolean canJump; 


erride 
tected void onCreate(Bundle savedInstancesState) { 
super.onCreate(savedInstanceState); 
setCcontentView(R.layout.activity_splash); 
container = (RelativeLayout) findViewById(R.id.container); 
// 进行 运行 时 权限 处 理 
List<String> permissionList = new ArrayList<>(); 
if (ContextCompat.checkSelfPpermission(this, Manifest.permission.READ_PHONE_ 
STATE) != PackageManager .PERMISSION_ GRANTED) { 
permissionList.add(Manifest.permission.READ_ PHONE_STATE); 


if (ContextCompat.checkSelfPpermission(this, Manifest.permission.ACCESS_ 
COARSE_LOCATION) != PackageManager .PERMISSION_ GRANTED) { 
permissionList.add(Manifest.permission.ACCESS COARSE_ LOCATION); 


if (ContextCompat.checkSelfpermission(this, Manifest.permission.WRITE_ 
EXTERNAL_STORAGE) != PackageManager .PERMISSION GRANTED) { 
permissionList.add(Manifest.permission.WRITE_EXTERNAL_STORAGE); 

} 

if (!permissionList,.isEmpty()) { 
String [] permissions = permissionList.toArray(new String[permissionList. 


size()]); 
ActivityCompat.requestPermissions(this, permissions, 1); 
} else { 
requestAds(); 
} 
请 求 开 屏 广告 


vate void requestAds() { 
String appId = "1105585573",; 
String adId = "4010212448179536"，; 
new SplashAD(this, container, appId, adId, new SplashADListener() { 
@Override 
public void onADDismissed() { 
// 广告 显示 完毕 
forward( ); 


Q@override 
public void onNoAD(int i) { 
// 广告 加 载 失败 


forward( ); 


} 


QOverride 

public void onADPresent() { 
// 广告 加 载 成 功 

} 


@Override 
public void onADClicked() { 
// 广告 被 点 击 


i 


}); 
} 


QOverride 

protected void onPause() { 
super .onpause( ); 
canJump = false; 


} 


QOverride 
protected void onResume() { 
super .onResume(); 
If (canJump) 区 
forward( ); 
} 


canJump = true,; 


} 


private void forward() { 
If (canJump) 区 
// 跳 转 到 MainActivity 
Intent intent = new Intent(this, MainActivity.class); 
startActivity(intent); 


finish(); 
} else { 
canJump = true,; 
} 
} 
QOverride 


public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 
case 1: 
If (grantResults.length > 0) { 
for (int result : grantResults) { 
if (result != PackageManager .PERMISSION_ GRANTED) { 
Toast .makeText(this,， "必须 同意 所 有 权限 才能 使 用 本 程序 "， 
Toast .LENGTH_SHORT) .show( ); 
finish(); 
return; 


} 


} 
requestAds( ); 
} else { 
Toast .makeText(this，" 发 生 未 知 错误 "，Toast .LENGTH_SHORT).show(); 
finish(); 


} 


break; 
default: 


可 以 看 到 ， 在 oncreate() 方法 中 ， 我 们 先是 获取 到 了 RelativeLayout 的 实 

例 ， 紧 接着 就 开始 进行 运行 时 权限 处 理 。 由 于 这 里 也 是 需要 在 运行 时 一 次 

| 因此 采用 了 和 11.3.2 小 节 同 样 的 写法 ， 相 信和 你 一 定 不 会 阳 
吧 。 


当 用 户 同 意 了 所 有 的 权限 申请 之 后 ， 就 会 调用 requestAds( ) 方法 来 请 求 广 
告 数据 。 在 requestAds( ) 方法 中 我 们 先是 定义 了 appId 和 adId 这 两 个 变量 ， 
它们 的 值 束 是 在 腾讯 广告 联盟 后 台 生 成 的 应 用 ID 和 广告 位 ID， 然 后 创建 
SplashAD 的 实例 来 获取 广告 数据 。SplashAD 的 构造 画 数 授 收 5 个 参数 ， 第 1 
个 参数 是 当前 活动 的 实例 ， 第 2 个 参数 是 RelativeLayout 的 实例 ， 第 3 个 参数 
是 应 用 ID， 第 4 个 参数 是 广告 位 ID， 相 信和 前 4 个 参数 都 没什么 需要 解释 的 。 
第 5 个 参数 是 一 个 SplashADListener 的 实例 ， 用 于 监听 广告 数据 的 回调 。 其 
中 onADDismissed() 方法 会 在 广告 显示 完毕 时 回调 ，onNoAD() 方法 会 在 广告 
加 载 失 败 时 回调 ，onAppPresent ( ) 方法 会 在 广告 加 载 成 功 时 回调 ， 
onADClLicked( ) 方法 会 在 广告 被 点 击 时 回调 。 当 广告 显示 完毕 或 者 广告 加 载 
失败 时 ， 我 们 调用 forward() 方法 跳 转 到 MainActivity， 并 将 当前 活动 天 闭 
即 可 。 


另外 注意 这 里 还 使 用 了 一 个 canJump 变量 用 于 对 活动 跳 转 进行 控制 。 这 是 因 
为 如 果 用 户 上 点击 了 广告 ， 会 局 动 一 个 新 的 活动 来 展示 广告 的 详细 内 容 ， 这 
个 时 候 即 使 回调 了 onAppismissed() 方法 ， 显 然 也 不 应 该 启动 MainActivity， 
因此 我 们 在 onPause() 方法 中 将 canJump 设 置 成 了 false 。 然后 在 forward() 
方法 中 发 现 canJump 是 false ， 因 此 不 会 进行 跳 转 ， 但 是 会 将 canJump 设 置 成 
true 。 最 后 ， 当 用 户 看 完了 广告 回 到 SplashActivity 时 ，onResume( ) 方法 将 
会 执行 ， 这 个 时 候 发 现 canJump 是 true ， 因 此 就 会 调用 forward( ) 方法 来 局 
动 MainActivity 。 


整体 流程 大 概 就 是 这 个 样子 了 ， 接 下 来 我 们 还 需要 将 主 活动 设置 成 
SplashActivity 而 不 再 是 MainActivity， 人 否则 广告 界面 将 无 法 得 到 展示 。 修 改 
AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.coolweather .android"> 


<application 


android: 


android 
android 
android 


name="org.litepal.LitePpalApplication" 


:allowBackup="true" 
:icon="@mipmap/logo" 
:label="@string/app_name" 
android: 
android: 


supportsRtl="true" 
theme="@style/AppTheme"> 


<activity android:name=" .MainActivity"> 

</activity> 

<activity android:name=".SplashActivity"> 
<intent-filter> 


<action android:name="android,.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 


</intent-filter> 
</activity> 


</application> 


</manifest> 


这 样 我们 束 将 广告 SDK 全 部 对 接 完 成 了 ， 现 在 可 以 重 痢 运行 一 下 程序 来 看 


一 看 效果 。 不 过 需要 注意 ， 广 告 在 模拟 器 上 是 不 会 显示 的 ， 我 们 要 用 真正 


的 手机 测试 才 行 


,程序 启动 后 首先 会 弹出 运行 时 权限 的 申请 对 话 杠 ， 全 首 


都 态 击 允许 之 后 束 能 看 到 广告 数据 了 ， 如 图 15.44 所 示 。 


遇见 你 | “ 衣 ” 往 情 深 


图 15.44 显示 广告 数据 
开 屏 广告 会 持续 5 秒 钟 时 间 ， 然 后 就 会 自动 跳 转 到 MainActivity 中 ， 后 面 的 
流程 就 和 之 前 是 完全 一 样 的 了 。 


15.4.4 ”重新 发 布 应 用 程序 


现在 我 们 已 经 成 功 在 酷 欧 天 气 中 接 入 了 广告 功能 ， 那 么 是 时 候 将 这 个 新 版 
本 更 新 到 360 应 用 商店 上 了 。 


由 于 即将 发 布 的 会 是 痢 一 版 的 酷 欧 天 气 ， 因 此 在 生成 安 痛 包 之 前 还 需要 修 
改 一 下 应 用 程序 的 版 本 号 信息 。 编 辑 app/build.gradle 文 件 ， 如 下 所 示 : 


android { 
compileSdkversion 24 


buildToolsVersion "24.0.2" 
defaultConfig { 
applicationId "com.coolweather.android" 
minSsdkVersion 15 
targetSdkVersion 24 
versionCode 2 
versionName "1.1" 


可 以 看 到 ， 这 里 将 versionCode 改 成 了 2，versionName 改 成 了 1.1°。 需要 注意 
的 是 ， 每 个 版 本 的 versionCode 和 versionName 都 不 能 和 其 他 版 本 相同 ， 且 新 
版 应 用 的 版 本 号 必须 大 于 老 版 应 用 的 版 本 号 。 


接 下 来 我 们 就 可 以 使 用 在 15.1 节 学 习 的 技术 来 生成 新 的 APK 文 件 ， 具 体 的 步 
又 天 不 再 重复 介绍 了 ， 最 终 会 生成 一 个 新 的 app-release.apk 文 件 ， 下 面 我 们 
将 它 重 新 发 布 到 360 应 用 商店 。 


打开 360 开 发 者 后 台 的 管理 中 心 页面 ， 然 后 点 击 酷 欧 天 气 的 更 新 管理 按钮 ， 
如 图 15.45 所 示 。 


酷 欧 天 气 虹 ” 医 到 
安检 结果 : 通过 。 坦 看 详情 


人 》 编辑 与 更 新 


图 15.45 “更 新 酷 欧 天 气 


点 击 编辑 与 更 新 按钮 ， 就 能 上 传 新 的 APK 文 件 了 。 注 意 上 传 之 后 仍然 会 提 
桓 应 用 的 安全 系数 较 低 ， 我 们 只 需要 使 用 和 之 前 同样 的 方式 进行 加 固 束 可 
Ts 


另外 ， 由 于 新 版 的 酷 欧 天 气 中 增加 了 一 些 人 敏感 隐私 权限 ， 因 此 我 们 还 需要 
在 这 一 项 上 面 做 出 说 明 ， 如 图 15.46 所 示 。 


系统 检测 到 此 APK 文 件 调用 了 用 户 手机 敏感 隐私 权限 ， 应 工信部 要 求 需 对 敏感 隐私 权限 的 获取 做 出 合理 说 明 。 
当前 AP 到 敏感 隐私 权限 列 款 : 
5 奖 或 丫 辟 化 得 


应 用 内 县 有 广告 功能 ， 需 获取 用 户 的 粗略 位 置 来 显示 更 加 合理 的 广 ©@ 


已 


图 15.46 ”对 敏感 隐私 权限 进行 说 明 


现在 只 需要 点 击 页 面 最 下 方 的 提交 审核 按钮 ， 新 版 本 的 酷 欧 天 气 束 发 布 成 
功 了 ， 当 然 还 需要 通过 360 的 审核 才 行 。 以 后 每 当 有 用 户 观看 或 点 击 了 应 用 
程序 中 的 广告 时 ， 我 们 就 能 真正 地 得 到 收益 。 在 腾讯 广告 联盟 的 后 台 管 理 
界面 可 以 查看 到 每 天 的 收益 情况 ， 如 图 15.47 所 示 。 


昨日 预 估 收益 近 7 日 收益 本 月 累计 收益 账号 总 收益 
0.01 a 0.02 a 0.02 a 0.02 a 


图 15.47 查看 广告 收益 情况 

你 的 应 用 越 成 功 ， 所 获得 的 广告 收益 也 会 越 多 ， 因 此 赶快 去 编写 更 多 优秀 
的 应 用 程序 来 赚 更 多 的 钱 吧 ， 相 信 通 过 整 本 书 的 学 习 ， 你 已 经 有 足够 的 能 
力 做 到 了 ! 


15.5 ”结束语 


就 这 样 ， 本 书 所 有 的 内 容 你 都 学 完了 ， 现 在 你 已 经 成 功 毕 业 ， 并 且 成 为 了 
一 名 合格 的 Android 开 发 者 。 但 是 如 果 想 要 成 为 一 名 出 色 的 Android 开 发 者 ， 


光 靠 本 书 中 的 这 些 理论 知识 以 及 少量 的 实践 还 是 不 够 的 ， 你 需要 真正 步 入 
到 工作 岗位 当中 ， 通 过 更 多 的 项 目 实战 来 不 断 地 历练 和 提升 目 己 。 


嘴 明 了 整 本 书 的 话 ， 但 是 到 了 最 后 却 不 知道 该 说 点 什么 好 ， 我 不 想 说 我 能 
教 你 的 就 只 有 这 些 了 ， 因 为 实际 上 我 想 教 你 或 者 和 你 一 起 探讨 的 内 容 还 有 
很 多 很 多 ， 不 过 限于 篇 幅 的 原因 ， 本 书 的 内 容 整 只 能 到 此 为 止 了 。 但 我 会 
长 期 在 博客 和 微 信 公众 号 上 面 分 享 更 多 Android 相 关 的 技术 文章 ， 如 采 感 兴 
趣 的 话 ， 可 以 到 我 的 博客 和 公众 号 中 继续 学 习 。 当 然 ， 如 末 对 本 书 中 的 内 
容 有 疑问 ， 也 可 以 到 博客 或 公众 号 中 给 我 留言 ， 我 的 博客 地 址 如 下 : 


http://guolin.tech 
扫 一 扫 下 方 二 维 码 即 可 关注 我 的 公众 


< 


好 了 ， 束 到 这 里 吧 ， 视 愿 你 未 来 的 Android 之 旅 都 能 愉快 。 


/= 
看 完了 
如 果 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@turingbook.com， 会 有 编辑 
或 作 译 者 协助 答疑 。 也 可 访问 图 灵 社 区 ， 参 与 本 书 讨 论 。 
如 果 是 有 天 电子 书 的 建议 或 问题 ， 请 联系 专用 客服 邮箱 : 


ebook@turingbook.com ° 


在 这 里 可 以 找到 我 们 : 


。 微 博 @ 图 灵 教 育 : 好 书 、 活 动 每 日 播报 

。 微 博 @ 图 灵 社 区 : 电子 书 和 好 文章 的 消息 

。 微 博 @ 图 灵 新 知 : 图 灵 教 育 的 科普 小 组 

。 微 信 图 灵 访 谈 : ituring_interview， 讲 述 码 农 精彩 人 生 
。 微 信 图 灵 教 育 : turingbooks 


图 灵 社 区 会 员 人 民 邮 电 出 版 社 (zhanghaichuan@ptpress.com.cn) 专 享 尊重 
版 权 
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